500+ native commands · full Huly operation parity

Run Huly from your terminal.

Huly CLI is a feature-complete command-line interface for Huly projects, issues, documents, chat, calendar, files, business workflows, and workspace administration. Use readable terminal output interactively or structured JSON in scripts and coding agents.

Install Huly CLI View on npm Source and reference

Install or run instantly

Huly CLI requires Node.js 20 or later. Run the latest release without installing it:

pnpm dlx @firfi/huly-cli@latest projects list

Or install the huly command globally:

pnpm add --global @firfi/huly-cli
huly --help

Connect to Huly

Configure a reachable self-hosted or replacement hosted Huly deployment. Use an API token, or provide email and password credentials instead.

export HULY_URL=https://your-huly-instance.example.com
export HULY_WORKSPACE=your-workspace
export HULY_TOKEN=your-api-token

huly projects list

Hosted Huly at https://huly.app is being discontinued. New installations should target a reachable self-hosted or replacement hosted deployment.

Useful from the first command

Human-readable terminal output

Inspect projects, issues, documents, activity, and workspace state without parsing raw SDK records.

Structured JSON automation

Add --json, combine results with jq, or provide complete inputs from JSON files.

Guarded consequential actions

Deletion, access changes, and other consequential operations require explicit --yes confirmation.

Huly CLI examples

# List projects as a table
huly projects list

# Read issue PROJ-123 as JSON
huly issues get PROJ 123 --json

# Create an issue from flags and a Markdown file
huly issues create \
  --project PROJ \
  --title "Fix login flow" \
  --description-file ./body.md

# Search the workspace
huly search "customer import" --limit 20 --json

# Download attachment bytes
huly attachments download 0123456789abcdef --output ./attachment.bin

More CLI examples Automation guide

Complete Huly operation coverage

Every shared Huly operation has exactly one native CLI route. The CLI and MCP server are maintained together in the same monorepo and derive from the same schema-owned operation registry.

projects
issues
documents
chat
calendar
Drive
boards
cards
time tracking
recruiting
support
test management
workspace administration
and more

Huly CLI or Huly MCP?

Choose the CLI for terminals, scripts, CI jobs, and direct subprocess execution. Choose Huly MCP when an MCP-compatible coding agent should discover and invoke Huly tools during a conversation.

Compare Huly CLI and Huly MCP