@companyhelm/agent-cli

Non-interactive npm TypeScript CLI wrapper around AgentTaskService.

Command Name

• companyhelm-agent

Config

Default config path:

~/.config/companyhelm-agent-cli/config.json

Required config fields:

{
  "agent_api_url": "127.0.0.1:50052",
  "token": "your-agent-token"
}

agent_api_url has no default value and must be set in the config file.

Task Commands

companyhelm-agent task create --name <name> [--description <text>] [--acceptance-criteria <text>] [--assignee-principal-id <id>] [--thread-id <id>] [--parent-task-id <id>]
companyhelm-agent task get --task-id <id>
companyhelm-agent task add-dependency --task-id <id> --dependency-task-id <id>
companyhelm-agent task dependencies --task-id <id>
companyhelm-agent task dependent --task-id <id>
companyhelm-agent task subtasks --task-id <id>
companyhelm-agent task comments --task-id <id>
companyhelm-agent task update-status --task-id <id> --status <draft|pending|in_progress|completed>
companyhelm-agent task add-comment --task-id <id> --comment <text>

Output Contract

• Success: JSON payload on stdout
• Failure: JSON error payload on stderr
• Exit code: non-zero on failure

Publish

Publishing to @companyhelm/agent-cli is automated by GitHub Actions:

npm version patch|minor|major
git push --follow-tags

Then push changes, this will publish a new package with the version already bumped.