CLI Reference

Complete reference for the HUMΛN CLI

The human CLI is your terminal entry point to the HUMΛN platform. It covers the full lifecycle from identity and intent to the Companion, agent deployment, and execution monitoring.

Installation

npm install -g @human/cli
# or
pnpm add -g @human/cli

Authentication

human login           # Device-flow login
human whoami          # Confirm identity + token status
human doctor          # Full environment health check

Command Families

Command	Description
`human companion`	Companion from the terminal — SSE streaming, REPL, slash commands, @mentions
`human live`	LiveSession control — start, status, stop, override, test-intent
`human ask`	Intent-driven: describe what you want, HUMΛN provisions it
`human intent`	Full intent pipeline control (build, compile, provision, REPL)
`human evidence`	LCEF evidence ingest, portfolio, eligibility, challenge
`human setup`	Install Agent Developer Kit (hooks, skills, agents, MCP) for Cursor or Claude Code
`human agent`	Agent init, dev, deploy, detect / import / check migration, catalog
`human prompts`	List, lint, render, cost, publish, rollback, and deprecate versioned prompts
`human marketplace`	search / browse / install (consumer) + init/lint/publish (author); org MCP mesh tools
`human trust`	Trust Observatory public catalog + org reports/webhooks
`human observatory`	Operator observatory — publish cards, aggregation runs
`human execution`	Monitor and control async executions
`human connector`	Connector scaffolding
`human doctor`	Environment + auth health check

Global Flags

Flag	Description
`--json`	Machine-readable JSON output (supported by all new commands)
`--verbose`	Verbose log output
`--debug`	Full debug output
`--help`	Command or subcommand help

Shell Completion

human completion bash >> ~/.bashrc
human completion zsh  >> ~/.zshrc
human completion fish >  ~/.config/fish/completions/human.fish

The completion list is generated at runtime from the live command registry, so new commands appear automatically.