Settings reference
Open Settings with the gear in the title bar. Eight tabs: AI Provider, Agent, Integrations, Custom Tools (Pro), Documents, Data, Appearance, License. Changes apply immediately; there is no Save button.
AI Provider
| Setting | Default | Notes |
|---|---|---|
| Provider | DeepState AI | Built in: DeepState AI, OpenAI-compatible, OpenRouter, Ollama. Plugins (enable under Plugins): Claude, OpenAI, OpenCode Zen, OpenCode Go. 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. OpenAI-compatible: base URL (or pick from the list) then API key. DeepState AI: none (uses the license). Ollama: none |
| Ollama server URL | http://localhost:11434 | Ollama only |
| Endpoint | — | OpenAI-compatible only: searchable list of models.dev providers, or any base URL ending in /v1 |
| 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 agent's header and above its input, per conversation. AI assistant.
Integrations
Each integration is a tile showing whether it is connected; click one to open its settings below the tiles. None are required.
| Integration | What to enter | Enables |
|---|---|---|
| TinyFish | API key (free) | Live web_search (web, news, research papers) and browser-rendered scrape_url |
| Exa | API key | Better web_search |
| CourtListener | API token | Court-records tools |
| GitHub | Personal access token | Higher search_github limits, code search |
| X / Twitter | Cookies JSON (recommended) or username/password/email, after acknowledging the ban risk | X search, timelines, user search, X feed subscriptions. Social media |
| Bluesky | Handle + app password | Higher limits; account-scoped visibility |
| Sign in through the LinkedIn window that opens (the session stays in DeepState's own browser profile) | Profiles, companies, people search and posts, within daily caps shown in its settings | |
| Blockchain | Etherscan V2 key (one key covers every EVM chain); optional Solscan Pro key | EVM wallet balances and transactions. Solana works without a key (Solscan adds token names and USD values); Bitcoin needs none |
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.
Documents
Folders of PDFs, Word files, text, Markdown, HTML and .eml emails attached to the current board,
with per-folder re-scan, stop, file list and remove. The assistant searches their text.
Document folders.
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.
Appearance
| Setting | Default | Notes |
|---|---|---|
| Theme | System | System, Dark or Light |
| Layout | Merged | Merged: the agent and the board side by side as two panes. Agent: full-window chat over the live board. Board: the board fills the window and the agent is an ask bar. Also switchable from the bottom bar or Ctrl+1/2/3 |
| Text size: Interface | 100% | Menus, dialogs, node sheets, settings and the bars: 90%, 100%, 110%, 125% or 140%. Also Ctrl/⌘++ and −; Ctrl/⌘+0 resets |
| Text size: Agent | 100% | The chat: messages, tool calls and the input |
| Text size: Nodes | 100% | Text on the board. Nodes grow with it, so a node shows as much of its text at any size |
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
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.