The hackable, local-first AI agent
Hooman reads your codebase, edits files, and runs commands — from your terminal, VS Code, or any Agent Client Protocol client. Bring your own model. Your config, keys, and sessions never leave~/.hooman.
Requires Node.js ≥ 24. Works locally out of the box via llama.cpp, plus Anthropic, OpenAI, Google, Ollama, and more.
Meets you where you work
One agent, one local config, three ways in — pick whichever fits the moment.
Terminal
hooman chat for a stateful Ink-powered TUI, hooman exec for one-shot prompts, and hooman daemon for channel-driven automation.
Explore the CLIVS Code
A native chat panel in the activity bar: streaming markdown, tool-call cards, a Changes panel with diff/keep/undo, and plan checklists.
VS Code extensionACP clients
hooman acp runs Hooman as an Agent Client Protocol agent over stdio for Zed and any other ACP-compatible editor.
About ACP
Stateful TUI, right in your terminal
An Ink-powered chat with a live status bar for model, effort, mode, and yolo.
Slash commands
/model, /mode, /effort, /sessions, /compact, and /config without leaving the prompt.
Context & cost at a glance
A usage row surfaces context-window %, token counts, and running session cost.
One-shot & automation
hooman exec for scripts and CI, hooman daemon for channel-driven automation.
Streaming chat, native to the editor
Markdown renders live in the activity bar as the agent thinks, with collapsible reasoning.
Tool-call cards
See every shell command, file edit, and search the agent runs, with inline permission prompts.
Changes panel
Per-file diffs with one-click keep or undo, backed by pre-edit baselines.
Plan checklists & quick pickers
Pinned plan tracking plus pill pickers for model/mode/effort, and /compact, /init commands.
Everything an agent toolkit needs
Toolkit-oriented architecture: configurable tools, prompts, and transports.
Chat, exec, daemon, ACP
A stateful chat TUI, one-shot exec, a channel-driven daemon, and an ACP agent — same core, four surfaces.
MCP + OAuth
stdio, streamable-http, and sse servers, with DCR and CIMD OAuth flows for remote servers that need auth.
Skills
Bundled built-in skills plus a local ~/.hooman/skills catalog the agent activates on demand.
Subagents
Built-in read-only subagent tools for research, review, and test investigation without derailing the main thread.
Tool approvals
Every destructive tool call is approved by default — chat, exec, and ACP each render an approval prompt; --yolo skips it.
Cost & context tracking
Context-window utilization and cumulative session cost, backed by the models.dev catalog, shown live in every surface.
Bring your own model
Twelve providers wired in today, normalized behind a single reasoning-aware configuration shape.
Event-driven automation, not just chat
hooman daemon subscribes to MCP servers that advertise the hooman/channelcapability, turning notifications from schedulers, ticket trackers, and chat platforms into agent prompts — with the same tool approval model as chat and exec.