VS Code

hooman-vscode adds a native Hooman chat panel to VS Code’s activity bar, backed by hooman acp. Works in stable VS Code, VS Code Insiders, and compatible forks — no proposed APIs, no special subscription. Local-first: configuration, API keys, and sessions live in ~/.hooman on your machine.

Requirements

• Node.js >= 24 — npx ships with it and is all the extension needs to launch the agent. It downloads hoomanjs on first use.

Install the extension

Get it from the VS Code Marketplace.

Or install it without leaving your editor — open the Command Palette (Cmd/Ctrl+Shift+P) and run:

ext install VPZ.hooman-vscode

Or from a terminal, if the code CLI is on your PATH:

code --install-extension VPZ.hooman-vscode

First run

1. Click the Hooman icon in the activity bar and send a prompt. The extension spawns npx hoomanjs acp for you — no separate CLI install required.

2. Pick your provider and model. Out of the box, Hooman runs a local Qwen3 model via llama.cpp (downloaded from the Hugging Face Hub on first use, with a live progress strip in the panel), with Qwen3.5 and Gemma 4 preconfigured as alternatives. To use a hosted provider instead:

   • click Open Settings… (gear icon in the panel title bar) to edit ~/.hooman/config.json directly, or
   • run npx hoomanjs in a terminal and use the /config workflow.

   See Configuration and Models for the full schema.

3. Explore the panel: streaming markdown, tool-call cards, a pinned Changes panel with diff/keep/undo, plan checklists, and slash commands.

Next steps

• VS Code guide — full feature list, commands, settings, troubleshooting, and building from source.
• ACP — how the extension talks to the agent.
• CLI quickstart — prefer a terminal instead?