Settings

Open Settings with Ctrl+, (or Cmd+, on macOS), or click the gear icon in the status bar. Settings are organised into five tabs.

Account

Manage your Ironspire account, active sessions, and licence.

• Account details: email, subscription tier, and a link to manage your account on ironspire.dev. Click the external link to update billing or change your plan.
• Sessions: view and revoke active sessions across devices. Your current session is highlighted with a badge. Click Revoke next to any other session to sign it out remotely.
• Data export: download your profile, subscription history, and agent configurations as a JSON file. Useful for backups or migrating between machines.
• Licence: enter or replace a licence key for offline activation. The panel shows your current tier, activation count, and validation status.
• GitHub connection: link your GitHub account for repository-aware features like blueprint population and git intelligence. Click Connect GitHub and authorise the OAuth flow. Once connected, the button changes to show your GitHub username.

General

Day-to-day preferences and workspace behaviour. Changes here apply to all agents and sessions.

• Profile: view and rename the current project profile. The profile name appears in the title bar and is used to identify exported data.
• Appearance: chat font size (Small / Medium / Large) with a live preview. The preview updates as you cycle through options so you can see the result before committing.
• System tray: toggle "close to tray" so Ironspire stays running in the background when you close the window. This is useful when you want agents to keep working while the window is out of the way. Reopen by clicking the tray icon.
• Terminal: select a default shell from the auto-detected shells on your machine (PowerShell, Git Bash, cmd, zsh, etc.). This shell is used when you open a new terminal panel.
• IDE import: click the Import from IDE button to pull workspace settings (font size, theme preferences) from your default code editor. Ironspire detects common editors (VS Code, Cursor, Windsurf) and reads their settings files.

Providers

Configure which AI model providers your agents can use.

The Providers tab replaced the older "Backend" tab as of v3.11. Instead of a single backend toggle, you now configure multiple providers and assign them to agents independently.

Each provider appears as a card with credential fields, a model selector, and a health status indicator. Expand a card to enter your API key or connection details, then select a default model.

Ironspire supports 13 built-in providers across three groups (Primary, Cloud, and OpenAI-Compatible), plus custom endpoints for self-hosted models and unlisted providers.

Operations

Fine-tune how Ironspire manages agent sessions, budgets, and automation. The Operations tab is divided into three sub-sections.

Timing

Control event replay behaviour when reconnecting to a session or reviewing agent activity.

• Event replay window: choose how far back the event timeline reaches when you open the monitoring panel. Options: 1 hour, 4 hours, or 24 hours.

Shorter windows load faster and keep the timeline focused on recent activity. Longer windows give you a broader view when reviewing what happened overnight or during an extended session.

Limits

Set guardrails to prevent runaway spending.

• Daily budget: enter a maximum daily spend in USD. When the combined cost across all agents reaches this threshold, Ironspire pauses all active agents and sends a notification.

The budget resets at midnight UTC each day. You can resume agents manually after a budget pause by clicking Resume in the sidebar or raising the limit.

Automation

Configure automatic conversation management for long-running agent sessions.

• Compaction threshold (60-90%): the percentage of the context window that triggers automatic compaction. When a conversation fills this proportion of the model's context, Ironspire summarises older messages to free up space.
• Preserved turns (2-6): the number of recent message exchanges to keep intact after compaction. Higher values preserve more recent context but leave less room for the summary.

Compaction runs transparently in the background. Agents continue responding normally; you may notice a brief pause while the summary is generated. The original messages are archived and can be reviewed in the conversation history.

About

Application information, integrations, and notification preferences.

• Notifications: set the notification level: All events, Critical only (errors, escalations, budget alerts), or Off. Critical-only is a good default; it filters out routine events while still alerting you to problems that need attention.
• Analytics: toggle anonymous usage analytics on or off. When enabled, Ironspire sends aggregated, non-identifying usage metrics (feature popularity, crash reports) to help improve the product. No conversation content, API keys, or personal data is ever sent.
• Agent Relay: enable or disable direct agent-to-agent messaging for full-autonomy agents. When enabled, agents can communicate with each other through the IS-Relay protocol without human intervention. Disable this if you want every cross-agent message to go through you first.
• Version info: app, Electron, Node, and Chrome versions with a copy button. Click Copy to grab the full version string for bug reports.
• Links: quick links to the website, documentation, feedback form, and community (GitHub Discussions).

Next steps

• Set up providers and models
• Configure agents
• Track costs in analytics