CLI Reference

Mon, 01 Jan 0001 00:00:00 +0000

Global flags

Flag	Description
`--help`	Show help for any command
`--version`	Print version
`--table`	Compact table format

Issue tracker commands

All issue trackers (jira, github, gitlab, linear, azuredevops, shortcut) share the same command structure:

List issues

human <tracker> issues list --project=<PROJECT>

Get an issue

human <tracker> issue get <ID>

Create an issue

human <tracker> issue create --project=<PROJECT> "Title"
human <tracker> issue create --project=<PROJECT> "Title" --description "Detailed description"

Add a comment

human <tracker> issue comment add <ID> "Comment text"

List comments

human <tracker> issue comments <ID>

Transition an issue

human <tracker> issue transition <ID> "Status"

Shortcut commands

human get <KEY>                      # Get an issue (auto-detect tracker)
human list --project=<PROJECT>       # List issues (auto-detect tracker)
human tracker list                   # List configured trackers

These shortcut commands work when only one tracker type is configured. When multiple tracker types are configured, use the provider-specific commands.

Troubleshooting

Mon, 01 Jan 0001 00:00:00 +0000

“command not found” after install

The human binary is not in your PATH. The install script places it in ~/.local/bin/ by default.

# Add to your shell profile (~/.bashrc, ~/.zshrc, etc.)
export PATH="$HOME/.local/bin:$PATH"

Reload your shell or run source ~/.bashrc (or ~/.zshrc).

Auth failures

Wrong token or expired token:

# Regenerate the daemon token
human daemon token

Copy the new token into your HUMAN_DAEMON_TOKEN environment variable.

Wrong environment variable name:

Reference on human - The AI dev rig for AI coding agents