Huly Assist

Interact with a Huly project management workspace via the huly CLI.

Environment Variables

Required before any command:

HULY_HOST — Huly instance URL (e.g. https://huly.app)
HULY_WORKSPACE_ID — workspace UUID from Huly Settings > Workspace
HULY_API_KEY — API token from Huly Settings > API Tokens

Execution

Run commands via the huly binary. If not found globally, fall back to node dist/index.js from the repo root.

All commands support --json for structured JSON output (preferred for programmatic agent use).

Commands

Connection

huly whoami                    # Verify connection + show account info

Projects

huly projects                  # List all projects in the workspace

Tasks

huly tasks --assignee me                          # My active tasks
huly tasks --project DELTA --status "In Progress" # Filter by project + status
huly tasks --overdue                              # Overdue tasks only
huly tasks --due-today                            # Due today only

huly task DELTA-123                               # Full details for one task

huly create task "Title" --project DELTA          # Create task (required: --project)
  --priority HIGH --due tomorrow --assignee me    # Optional: priority, due date, assignee
  --kind-id <id> --component-id <id>              # Optional: task type, component
  --milestone-id <id>                             # Optional: milestone
  --set-field "customKey=value"                   # Optional: custom fields

huly update task DELTA-123                        # Update task
  --status "Done" --priority URGENT               # Change status/priority
  --due 2026-04-01 --assignee me                  # Change due date/assignee
  --add-comment "Progress update"                 # Add comment
  --description-file ./spec.md                    # Set description from file

huly delete task DELTA-123 --yes                  # Delete (requires --yes)

Reports

huly report daily --assignee me    # Tasks due today + overdue summary
huly report weekly                 # Tasks due this week + overdue summary

Labels / Tags

huly labels list                                  # List all workspace labels
huly labels create "bug" --color 3                # Create a label
huly labels assign DELTA-123 <labelId>            # Assign label to issue
huly labels show DELTA-123                        # Show labels on an issue

Documents

huly docs teamspaces                              # List all teamspaces
huly docs list "My Documents"                     # List docs in a teamspace
huly docs read "My Documents" "Meeting Notes"     # Read doc as markdown
huly docs create "New Doc" -t "My Documents"      # Create document
  --content "# Hello" OR --file ./content.md      # Content: inline or file
huly docs create-teamspace "Engineering"           # Create new teamspace
  --description "Team docs" --private              # Optional: description, private

Milestones

huly milestones list --project DELTA                   # List project milestones
huly milestones create "Sprint 1" --project DELTA      # Create milestone
  --target 2026-04-15                                  # Optional: target date
huly milestones complete <milestoneId> --project DELTA # Mark as completed

JSON Mode

Append --json to any command for structured output. All JSON responses follow:

{ "status": "ok", "data": {...} }
{ "status": "error", "error": "message" }

Error Handling

Errors display in Vietnamese (prefix Loi:). Parse the message and report failure to the user. Do not attempt to call Huly API routes directly — always use the CLI as the source of truth.

Priority Levels

Value	English	Vietnamese
0	None	KHONG UU TIEN
1	Low	THAP
2	Medium	TRUNG BINH
3	High	CAO
4	Urgent	KHAN CAP

Input accepts: number (0-4), English name, or Vietnamese name.

Date Formats

Due dates accept: YYYY-MM-DD, today, tomorrow.

huly-assist