Settings Reference

Configure GRID via Settings → Preferences or edit settings.json directly.

Secret Detection

Automatically detect and redact secrets before sending to AI providers.

Setting	Type	Default	Description
grid.secretDetection.enabled	boolean	true	Enable secret detection and redaction
grid.secretDetection.mode	enum	"redact"	`block` or `redact`
grid.secretDetection.disabledPatternIds	array	[]	Disable specific detection patterns
grid.secretDetection.customPatterns	array	[]	Add custom regex patterns

Available Pattern IDs: openai-key, anthropic-key, generic-api-key, jwt-token, bearer-token, aws-access-key, aws-secret-key, github-token, gitlab-token, google-api-key, stripe-key, password-pattern, private-key, generic-token

Safety & Rollback

Setting	Type	Default	Description
grid.safety.rollback.enable	boolean	false	Enable file snapshots before AI changes
grid.safety.rollback.maxSnapshotBytes	number	5000000	Max bytes per snapshot (5MB default)

Global Settings

Setting	Type	Default	Description
grid.global.localFirstAI	boolean	false	Prefer local models (Ollama) over cloud

Web Search APIs

Configure search providers for AI agent web research. DuckDuckGo requires no API key.

Setting	Provider	Get Key
grid.browserSubagent.preferredProvider	Search priority	auto, tavily, brave, serper, etc.
grid.browserSubagent.tavilyApiKey	Tavily (recommended)	tavily.com
grid.browserSubagent.braveApiKey	Brave Search	brave.com/search/api
grid.browserSubagent.serperApiKey	Serper (Google SERP)	serper.dev
grid.browserSubagent.exaApiKey	Exa (Neural Search)	exa.ai
grid.browserSubagent.perplexityApiKey	Perplexity	perplexity.ai
grid.browserSubagent.firecrawlApiKey	Firecrawl	firecrawl.dev
grid.browserSubagent.jinaApiKey	Jina AI	jina.ai

Vector Store (Advanced)

Optional vector database for enhanced codebase search.

Setting	Type	Default	Description
grid.rag.vectorStore	enum	"none"	`none`, `qdrant`, or `chroma`
grid.rag.vectorStoreUrl	string	—	URL to vector store endpoint

Example settings.json

{
  "grid.global.localFirstAI": true,
  "grid.secretDetection.enabled": true,
  "grid.secretDetection.mode": "redact",
  "grid.safety.rollback.enable": true,
  "grid.browserSubagent.preferredProvider": "tavily",
  "grid.browserSubagent.tavilyApiKey": "tvly-..."
}