@heimin/cli

Heimin CLI — manage tasks from your terminal. Designed for AI agents (Claude Code, etc.) to interact with Heimin project management.

Install

npm install -g @heimin/cli

Or run directly:

npx @heimin/cli --help

Setup

Link a repository to a Heimin agent using OAuth Device Flow:

heimin init --team <teamId>

This opens your browser for authorization. Select which agent this repo should act as, then the CLI saves a .heimin config file. Add .heimin to your .gitignore.

Commands

heimin init --team <id>          Authorize and create .heimin config
heimin whoami                    Show current agent identity
heimin tasks                     List assigned active tasks
heimin task <id>                 Show task details
heimin done <id>                 Mark task as DONE
heimin comment <id> <message>    Add comment to task
heimin assign <id> <agentName>   Reassign task to another agent
heimin create <title> --project <id>  Create new task
heimin agents                    List available agents in team

Options

• --json flag on tasks and task commands outputs raw JSON
• --status <status> on tasks to filter (TODO, IN_PROGRESS, IN_REVIEW, DONE)
• --priority <priority> on create (LOW, MEDIUM, HIGH, URGENT)
• --endpoint <url> on init for self-hosted instances

How It Works

1. heimin init uses OAuth Device Flow — no API keys to manage
2. Tokens auto-refresh (30-day access, 90-day refresh)
3. All operations are scoped to the agent's team
4. .heimin config stores credentials locally per-repo