Huly Assist

A CLI tool and agent skill for managing tasks, projects, labels, documents, and milestones in Huly — built on the official @hcengineering/api-client.

Works with Claude Code, Cursor, OpenCode, and any agent supporting the Agent Skills ecosystem.

Install as Agent Skill

npx skills add fioenix/huly-skill

Or manually (zero-install — no npm install needed):

git clone https://github.com/fioenix/huly-skill.git
cd huly-skill

Setup

Set these environment variables before using any command:

export HULY_HOST="https://huly.app"
export HULY_WORKSPACE_ID="your-workspace-uuid"
export HULY_API_KEY="your-api-token"

• HULY_HOST: Your Huly instance URL
• HULY_WORKSPACE_ID: Found in Huly Settings > Workspace
• HULY_API_KEY: Create at Huly Settings > API Tokens

Verify

./bin/huly.cjs whoami

Usage

Tasks

huly tasks --assignee me              # My tasks
huly tasks --project DELTA --overdue  # Overdue in project
huly task DELTA-123                   # Task details
huly create task "Title" --project DELTA --priority HIGH --due tomorrow
huly update task DELTA-123 --status "Done" --add-comment "Completed"
huly delete task DELTA-123 --yes      # Requires confirmation

Reports

huly report daily --assignee me       # Today's summary
huly report weekly                    # Week summary

Labels

huly labels list                      # All labels
huly labels create "bug" --color 3    # Create label
huly labels assign DELTA-123 <id>     # Assign to task
huly labels show DELTA-123            # Show task labels

Documents

huly docs teamspaces                  # List teamspaces
huly docs list "My Documents"         # List docs
huly docs read "My Documents" "Notes" # Read as markdown
huly docs create "Title" -t "My Documents" --file ./content.md
huly docs create-teamspace "Engineering"

Milestones

huly milestones list --project DELTA
huly milestones create "Sprint 1" --project DELTA --target 2026-04-15
huly milestones complete <id> --project DELTA

JSON Mode

Append --json to any command for structured output:

huly tasks --assignee me --json

For AI Agents

See AGENTS.md for the full agent integration guide, or skills/huly-skill/SKILL.md for the skill definition.

Technical Notes

All dependencies are bundled into a single dist/bundle.cjs via esbuild — no npm install or GitHub PAT required. The @hcengineering/api-client expects browser APIs (indexedDB, window), which are polyfilled automatically.

License

MIT