Settings reference
Open Settings with the gear in the title bar. Six tabs: AI Provider, Agent, Integrations, Custom Tools (Pro), Data, License. Changes apply immediately; there is no Save button.
AI Provider
| Setting | Default | Notes |
|---|---|---|
| Provider | Claude | DeepState AI, Claude, OpenAI, OpenRouter, OpenCode Zen, OpenCode Go, Ollama. AI providers |
| Sign-in | — | Claude: Login with Claude Pro/Max (browser + paste code) or API key. OpenAI: Login with ChatGPT Pro/Plus or API key. OpenRouter / OpenCode: API key with Validate. DeepState AI: none (uses the license). Ollama: none |
| Ollama server URL | http://localhost:11434 | Ollama only |
| Model | provider default | Searchable list, fetched live, with pricing tier where available |
| Summarizer model | provider's cheap model | Used for all background AI. Summarizer |
| Provider usage | — | Read-only: subscription windows, tokens and cost, or credits, depending on provider |
Agent
| Setting | Default | Notes |
|---|---|---|
| Max response size | 150 000 tokens | Slider 10k-200k. Caps output per turn; higher allows longer answers and more tool calls |
| Smart tool loading | off | Start each conversation with core tools only and load groups on demand. Helps small and local models |
| Default tool groups | all | Shown when smart loading is on: Entities, Research, Social Media, Media, Narratives preloaded or not |
| Custom instructions | empty | Standing instructions appended to every conversation - style, citation rules, house conventions |
Mode (Plan / Investigate / Autoresearch) and reasoning depth are set in the AI panel itself, per conversation. AI assistant.
Integrations
| Section | What to enter | Enables |
|---|---|---|
| Twitter/X account | Cookies JSON (recommended) or username/password/email, after acknowledging the ban risk | X search, timelines, user search, X feed subscriptions. Social media |
| Bluesky account | Handle + app password | Higher limits; account-scoped visibility |
| Exa AI search | API key | Better web_search |
| CourtListener | API token | Court-records tools |
| GitHub | Personal access token | Higher search_github limits, code search |
Connected integrations show as indicators in the status bar. Research integrations.
Custom Tools PRO
Lists loaded tools with status, per-tool configuration forms and recent logs; Open folder, Reload (takes effect on restart), and built-in getting-started and API reference. Custom tools.
Data
| Action | Notes |
|---|---|
| Create backup | Writes a .deepstate-backup of everything |
| Restore from backup | Stages a restore, applied on next launch; previous data kept as *.pre-restore |
| Cancel pending restore | Shown when a restore is staged |
Backup & restore. Per-board export/import is on the board select screen.
License
| Item | Notes |
|---|---|
| Status | Tier badge, masked key, expiry, last validated |
| Manage subscription | Opens the Stripe billing portal (Personal and Pro) |
| AI usage | DeepState AI allowance used this month |
| Anonymous usage analytics | on by default. App opens and board creations, keyed by a hash of the license. No content |
| Transfer License / Deactivate | Frees the activation for another computer |
Settings that live elsewhere
- Sync transports per board: board select screen → Collaborate. Collaboration
- Feed polling, filters, placement: on each RSS Feed node. RSS feeds
- Timeline, node type filter, narrative filter: controls on the canvas
- Theme: the app is dark only
Where settings are stored
Non-secret settings are in config.json; keys and tokens are encrypted in secure-config.dat
and oauth-tokens.dat; all in the data folder. Settings are per machine - not
synced, not exported, not included in backups.