/ docs

Settings reference

Every hypex.* option. Search 'hypex' in the IDE settings or edit settings.json directly.

Settings reference — walkthrough
Video walkthrough coming soon.
Settings reference — walkthrough

Provider + model

KeyDefaultPurpose
hypex.provideranthropicanthropic / openai / openrouter / xai / ollama / claude-cli
hypex.modelclaude-sonnet-4-6Model id for the current provider
hypex.maxTokens8192Max tokens per agent response
hypex.openrouterBaseUrlhttps://openrouter.ai/api/v1Override OpenRouter endpoint
hypex.xaiBaseUrlhttps://api.x.ai/v1Override xAI endpoint
hypex.ollamaBaseUrlhttp://localhost:11434/v1Ollama server URL

Agent

hypex.agent.modemanualmanual / auto
hypex.agent.profiledefaultActive profile when mode is manual
hypex.agent.ollamaDefaultProfilelocal-unrestrictedProfile (display: Local) used when provider is Ollama
hypex.autoApproveToolsread-only setTool names to skip approval for

Ghost completions

hypex.ghost.enabledtrueMaster toggle
hypex.ghost.debounceMs500Delay after last keystroke
hypex.ghost.minCharsBeforeTrigger3Skip lines shorter than this
hypex.ghost.model(provider default)Override ghost model

Cost + budget

hypex.costs.enabledtrueTrack per-turn cost + tokens
hypex.costs.dailyBudget10USD — yellow at 80 %, red at 100 %
hypex.costs.warnAbove1.0Pre-turn confirm if estimated cost exceeds this

Battery

hypex.battery.savefalseDisables ghost auto-triggers + 3× LLM debounce + pauses CSS loops

Hardware diag

hypex.hardwareDiag.enabledtrueRun one-shot HW probe on first launch

Diagrams

hypex.diagrams.autoRendertrueAuto-render Mermaid / Graphviz fences in chat

Database

hypex.database.connections[]Array of connection entries
hypex.database.allowWritesfalseAllow query_database to run non-SELECT

MCP

hypex.mcp.servers{}Server config map (mirrors .hypex/mcp.json)
hypex.mcp.autoStarttrueStart configured servers on activation

Checkpoints

hypex.checkpoints.enabledtrueAuto-snapshot before every modifying tool batch
hypex.checkpoints.ignored(see pkg)Paths to skip when snapshotting

Remote

hypex.claudeCli.binaryPathclaudeOverride Claude Code CLI binary path

Ollama picker

hypex.ollama.quickPickModelsGemma 5 / 3n / Qwen / Phi / SmolLMRecommended models in Hypex: Select Local Ollama Model

Workspace overrides

Every setting can be overridden per-workspace in .vscode/settings.json. .hypex/* files (memory, steering, pins, specs, dev-servers, mcp) override per-workspace for Hypex-specific data.