Humfrid for VS Code

Your thinking partner in the editor — Chat grounded in your Humfrid workspace, and Code powered by Grok Build.

Not affiliated with or endorsed by xAI.

Open Humfrid


Activity bar	Humfrid H icon (left) → Open Humfrid
Editor title bar	Humfrid H icon (top-right, next to Split Editor)
Command Palette	`Humfrid: Open`
Shortcut	`Cmd+Shift+H` / `Ctrl+Shift+H`
Status bar	Humfrid (bottom-right; warns when not signed in)

Open a file so the title-bar icon appears.

Chat — Ask Humfrid about goals, decisions, and work (Humfrid MCP)
Code — Agentic coding via Grok Build; optional Humfrid tools when signed in
Settings ⚙ — API key, MCP URL, chat thinking depth, code model, reasoning, permissions
Images — Attach or paste images (vision in Code when supported; saved under .humfrid/uploads)
Permission modes — Ask · Auto-edit · Plan · Full access (Code tab)
Stop / Clear — Cancel in-flight work; clear this tab’s conversation only
Separate histories — Chat and Code keep independent message threads, drafts, and attachments
Editor context — Active file + selection sent with each turn (@ refreshes)

Install from the Marketplace: Humfrid.humfrid
Chat (Humfrid) — Settings → Sign in with an API key (mmt_…)
Create keys at app.humfrid.com
Code (Grok / SuperGrok) — install Grok Build CLI, then Settings → Connect Grok
That runs grok login --oauth so your SuperGrok / X Premium+ subscription signs in via the browser.
Optional: Paste API key (xAI key) instead of OAuth.

Setting	Default
`humfrid.mcpUrl`	`https://mcp.humfrid.com/mcp/v3`
`humfrid.chat.thinking`	`medium`
`humfrid.code.model`	`grok-4.5`
`humfrid.code.reasoning`	`high`
`humfrid.code.permissionMode`	`default` (Ask / Auto-edit / Plan / Full access)
`humfrid.code.autoAttachMcp`	`true`
`humfrid.grokAcp.cliPath`	auto-detect

API keys stay in VS Code SecretStorage on your machine (never in settings.json).
Chat uses your Humfrid MCP endpoint; Code uses the local Grok Build CLI.
Errors are redacted so tokens are not echoed into the chat UI.
See SECURITY.md.

Symptom	Fix
Title-bar icon missing	Open any file tab (not Output/Debug only)
Chat fails to connect	Sign in; check `humfrid.mcpUrl` and network
Code: CLI not found	Install Grok Build; set Grok CLI path if needed
Marketplace stuck on old version	Wait for validation, or install the VSIX from a release

Proprietary — Humfrid / Avery Intelligence.
Open-source coding host: vscode-grok-acp (MIT).