Skip to content

Profiles and workspaces

Profiles are how Ironspire isolates your projects. Each profile points to a project directory and maintains its own agents, conversations, terminals, and file tree. You can switch between profiles instantly.

Creating a profile

  1. Click + New Project in the profile selector (top of the left sidebar)
  2. Enter a project name and select a project directory using the folder picker
  3. Optionally, add agents from presets during creation
  4. Click Create Project

Ironspire switches to the new profile automatically.

Switching profiles

Click the profile selector dropdown at the top of the left sidebar. Your profiles are listed with a checkmark on the active one. Click any profile to switch.

Switching profiles reloads the file tree, clears terminal sessions, and switches to the new project's agent list. Conversations and agent state are preserved per profile.

Deleting a profile

  1. Open the profile selector dropdown
  2. Hover over a non-active profile to reveal the trash icon
  3. Click the trash icon and confirm

You cannot delete the currently active profile.

What's isolated per profile

Each profile is a self-contained workspace:

Scoped to profileShared globally
Agents and conversationsAPI key / CLI config
File tree and working directoryApp settings
Terminal sessionsLicense / subscription
Memory (corpus data)MCP server installs
Blueprint milestones and phases

Next steps