@humain/humain-code
v0.4.7
Published
Coding agent CLI with read, bash, edit, write tools and session management
Maintainers
Readme
Upstream Pi automatically closes new issues and PRs from new contributors; see its contribution policy.
HUMAIN Code CLI
HUMAIN Code CLI is a minimal, extensible AI agent for the terminal. Adapt it to your workflow. Customize it with extensions, skills, prompt templates, and themes. Bundle them as HUMAIN Code CLI packages and share via npm or git.
Use HUMAIN Code CLI interactively, automate it in print or JSON mode, control it over RPC, or build applications with the TypeScript SDK.
The built-in subagent tool discovers user agents in ~/.humain-terminal/agent/agents and, when requested, project-local agents in .humain-terminal/agents. Project-local agents are repository-controlled: untrusted interactive projects require a per-call confirmation, while trusted projects use the existing project-trust decision without prompting again.
HUMAIN Code CLI runs in five modes: interactive, print or JSON, RPC, host-managed agent-exec, and an SDK for embedding in your own apps.
Getting started
Install the command-line interface with npm:
npm install -g --ignore-scripts @humain/humain-codeThis requires Node.js 22.22.2 or newer. HUMAIN Code CLI does not require dependency lifecycle scripts for a normal npm installation.
On macOS and Linux, Nix users can build and run HUMAIN Code CLI from this checkout with nix run ..
Start HUMAIN Code CLI in the directory where you want it to work:
cd /path/to/project
humain-codeThe humain-code CLI is also available through the humain-code-cli, hc, hcc, ht, and humain aliases. The old humain-terminal command still works but is deprecated. The npm package is @humain/humain-code (formerly @humain/terminal). The .humain-terminal config directory and HUMAIN_TERMINAL_* environment variables are unchanged.
See the documentation for full setup and usage instructions.
Development
Clone the repository, install its dependencies, and run the development build:
git clone https://gitlab.humain.com/humain/data-and-ai-modeling/standard/agentic/humain-terminal.git
cd humain-terminal
npm install --ignore-scripts
./humain-terminal-test.shhumain-terminal-test.sh can be called from any directory and preserves the caller's working directory.
Before submitting changes, run:
npm run check
./test.shFor HUMAIN Code CLI contribution instructions, see CONTRIBUTING.md and Development. Upstream Pi contributions follow the linked upstream CONTRIBUTING.md and AGENTS.md.
HUMAIN Code CLI also bundles web access and an MCP adapter and supports HUMAIN Node and Forge/DeployNow integrations. See HUMAIN Code CLI for those fork-specific workflows.
License
MIT
