Skip to main content

CLI Reference

HUMΛN CLI Reference

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.