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.
Features
- 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)
Setup
- 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 runsgrok login --oauthso your SuperGrok / X Premium+ subscription signs in via the browser.
Optional: Paste API key (xAI key) instead of OAuth.
Settings (VS Code)
| 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 |
Privacy & security
- 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.
Troubleshooting
| 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 |
License
Proprietary — Humfrid / Avery Intelligence.
Open-source coding host: vscode-grok-acp (MIT).
v0.4.0 highlights
- Browser Sign in / Create account (OAuth PKCE) or paste
mmt_key - Connect Grok SuperGrok OAuth with live connected banner
- Per-tab history persists across restarts
- Queue messages while busy; coded errors with Retry
- Walkthrough: Get started with Humfrid