Riggr

Settings

Everything you can configure in Riggr, where it lives, what changes.

Settings

Open with Ctrl+Shift+P → search Settings (or the gear icon in the title bar). Settings are split into eight tabs.

General

  • Theme — four options (dark, dimmed, oled, white). Applied instantly via the data-theme attribute on <html>, with CSS vars injected per theme.
  • Language — pt-BR or en-US. Persisted to localStorage and used both for the app UI and these docs.

API Keys

Riggr does not ask for an AI provider key. Claude Code, Codex, and Gemini CLI handle their own login (an auth link opens in your browser on first run). You don't paste an Anthropic, OpenAI, or Google token anywhere in Riggr.

This tab is for credentials to external tools you want available to the agent. Everything is encrypted via Electron's safeStorage (DPAPI on Windows, Keychain on macOS, libsecret on Linux). Never sits on disk in plaintext.

Common cases:

  • GitHub token — for the GitHub MCP (issues, PRs, code search).
  • Docker Hub — for the Docker Node to pull private images.
  • Other MCP tokens — any external integration that needs auth (Linear, Notion, Stripe, etc.).

Add, edit, or remove from the form. No restart needed.

Agent

  • Default CLI agent — which command the Agent Terminal uses when you create a new one: claude-code, codex, gemini, or a custom path.
  • RIGGR.md — toggle that injects a protocol into the agent's system prompt, instructing it to read and update RIGGR.md at the workspace root. Use it for persistent project memory that grows over time.

MCP

List of MCP (Model Context Protocol) servers — extra tool sources for the agent. Add, remove, toggle, and open the config file (riggr-mcp.json) directly in the system editor. Full details in MCP servers.

Workspace

  • Autosave interval — default 500ms (minimum). Sets the .riggr write debounce.
  • Recents history — clears the home screen list.

Privacy

  • Telemetry — toggle. On by default; sends anonymized events (app version, platform, session ID) to getriggr.app/api/telemetry. Never sends workspace content, prompts, or code.
  • Clear data — wipes localStorage, onboarding flags, and preferences. Does not touch your .riggr files — those stay where they always were.

Shortcuts

Read-only table of every shortcut in the app. No remapping yet. The full list also lives in Essential shortcuts.

Account

  • Email, avatar, license purchase date.
  • Logout button — signs out this machine and drops the local token.
  • Warning when the token is about to expire.

Where it all lives on disk

  • License token: <userData>/riggr-license.json (encrypted).
  • Device fingerprint: <userData>/riggr-device.json (encrypted).
  • MCP config: <userData>/riggr-mcp.json.
  • API keys: OS keychain.
  • Workspaces: <userData>/workspaces/<name>/<name>.riggr (or wherever you chose).

<userData> is %APPDATA%/riggr-app on Windows, ~/Library/Application Support/riggr-app on macOS, ~/.config/riggr-app on Linux.