Skip to content

Settings

Open Settings with Ctrl+, or click the gear icon in the sidebar. Settings are organised into four tabs.

Account

Manage your Ironspire account, active sessions, and license.

  • Account details: email, subscription status, and a link to manage your account on ironspire.dev
  • Sessions: view and revoke active sessions across devices. Your current session is highlighted.
  • Data export: download your profile, subscription history, and agent configurations
  • License: enter or replace a licence key for offline activation. Shows tier, activation count, and status.

General

Day-to-day preferences.

  • Profile: view and rename the current project profile
  • Appearance: chat font size (Small / Medium / Large) with a live preview
  • System tray: toggle "close to tray" so Ironspire stays running when you close the window
  • Terminal: select a default shell from the auto-detected shells on your machine (PowerShell, Git Bash, cmd, etc.)

Backend

Configure how Ironspire connects to Claude.

  • Backend mode: switch between CLI (uses your Claude subscription) and API (pay-per-token with an API key)
  • API key: paste your Anthropic API key. It is encrypted at rest and validated automatically. Status indicators show connection health.
  • Default model: choose the default Claude model (Sonnet 4.5, Haiku 4.5, or Opus 4.6). Individual agents can override this.
  • Auto-compaction: configure automatic conversation compaction for long sessions:
    • Context threshold (60-90%): when to trigger compaction
    • Preserved turns (2-6): how many recent exchanges to keep

When a conversation approaches the context window limit, Ironspire automatically summarizes older messages to free up space while preserving recent context.

About

Notifications, integrations, and app info.

  • Notifications: set the notification level: All events, Critical only (errors, escalations, budget alerts), or Off
  • Analytics: toggle anonymous usage analytics
  • Agent Relay: enable or disable direct agent-to-agent messaging for full-autonomy agents
  • Budget: set a daily spending alert threshold
  • Version info: app, Electron, Node, and Chrome versions with a copy button
  • Links: website, documentation, feedback, and community

Next steps