Commands are for your agent.#

Daily users delegate in plain language. This generated command reference helps setup agents, maintainers and debugging. Multiline bodies use files or structured MCP inputs, and global options precede subcommands.

Top-level help#

usage: cu-work [-h] [--project-dir PROJECT_DIR]
               {init,context,doctor,route,task,focus,subtask,progress,link-pr,link-github,sync-comments,phase,reconcile,mcp}
               ...

cu-work: local project context plus deterministic, scoped workflow operations.

positional arguments:
  {init,context,doctor,route,task,focus,subtask,progress,link-pr,link-github,sync-comments,phase,reconcile,mcp}
    init                Create the shared binding; performs no remote writes
    mcp                 Serve task-scoped workflow tools over stdio

options:
  -h, --help            show this help message and exit
  --project-dir PROJECT_DIR
                        Target Git worktree, never the plugin install
                        directory

init#

usage: cu-work init [-h] --name NAME --objective OBJECTIVE --workspace
                    WORKSPACE --list LIST --repository REPOSITORY --task TASK
                    [--base-branch BASE_BRANCH] [--runtime {cup,rest-mcp}]
                    [--cup-profile CUP_PROFILE]

options:
  -h, --help            show this help message and exit
  --name NAME
  --objective OBJECTIVE
  --workspace WORKSPACE
  --list LIST
  --repository REPOSITORY
  --task TASK
  --base-branch BASE_BRANCH
  --runtime {cup,rest-mcp}
  --cup-profile CUP_PROFILE

context#

usage: cu-work context [-h]

options:
  -h, --help  show this help message and exit

doctor#

usage: cu-work doctor [-h]

options:
  -h, --help  show this help message and exit

route#

usage: cu-work route [-h] --available AVAILABLE
                     {task.get,task.context,task.subtask,task.comment,task.status,task.search,task.custom-field,task.dependency,docs.search,chat.send,github.pr,github.issue,github.comment,github.checks}

positional arguments:
  {task.get,task.context,task.subtask,task.comment,task.status,task.search,task.custom-field,task.dependency,docs.search,chat.send,github.pr,github.issue,github.comment,github.checks}

options:
  -h, --help            show this help message and exit
  --available AVAILABLE
                        Comma-separated backends actually available in this
                        session

task#

usage: cu-work task [-h] [--task TASK]

options:
  -h, --help   show this help message and exit
  --task TASK

focus#

usage: cu-work focus [-h] [--task TASK]

options:
  -h, --help   show this help message and exit
  --task TASK

subtask#

usage: cu-work subtask [-h] [--task TASK] --key KEY --title TITLE
                       --description-file DESCRIPTION_FILE
                       [--github-target GITHUB_TARGET]

options:
  -h, --help            show this help message and exit
  --task TASK
  --key KEY             Stable key, reused only for identical inputs
  --title TITLE
  --description-file DESCRIPTION_FILE
  --github-target GITHUB_TARGET
                        Bound repo/issue/PR URL; default creates/reuses an
                        issue

progress#

usage: cu-work progress [-h] [--task TASK] --key KEY --message-file
                        MESSAGE_FILE

options:
  -h, --help            show this help message and exit
  --task TASK
  --key KEY             Stable key, reused only for identical inputs
  --message-file MESSAGE_FILE

link-pr#

usage: cu-work link-pr [-h] [--task TASK] --key KEY --pr PR

options:
  -h, --help   show this help message and exit
  --task TASK
  --key KEY    Stable key, reused only for identical inputs
  --pr PR

link-github#

usage: cu-work link-github [-h] [--task TASK] --key KEY --target TARGET
                           [--title TITLE]
                           [--description-file DESCRIPTION_FILE]

options:
  -h, --help            show this help message and exit
  --task TASK
  --key KEY             Stable key, reused only for identical inputs
  --target TARGET       Bound repo/issue/PR URL or new-issue
  --title TITLE         Required for new-issue
  --description-file DESCRIPTION_FILE

sync-comments#

usage: cu-work sync-comments [-h] [--task TASK]
                             [--direction {both,to-clickup,to-github}]

options:
  -h, --help            show this help message and exit
  --task TASK
  --direction {both,to-clickup,to-github}

phase#

usage: cu-work phase [-h] [--task TASK] --key KEY [--pr PR] --phase
                     {in_progress,review,done}
                     [--verification-file VERIFICATION_FILE]

options:
  -h, --help            show this help message and exit
  --task TASK
  --key KEY             Stable key, reused only for identical inputs
  --pr PR
  --phase {in_progress,review,done}
  --verification-file VERIFICATION_FILE

reconcile#

usage: cu-work reconcile [-h] --key KEY
                         (--result-file RESULT_FILE | --not-applied)

options:
  -h, --help            show this help message and exit
  --key KEY
  --result-file RESULT_FILE
  --not-applied

mcp#

usage: cu-work mcp [-h]

options:
  -h, --help  show this help message and exit