Raw capture — raw/xirp.md
url: https://backstage.spotify.com/docs/xirp date_fetched: 2026-08-14
Run Claude Code, Codex, or Gemini in persistent terminal sessions and switch between them without losing state.
Connect Spotify Portal to give agents access to Workspace wiki pages, catalog entities, resources, records, members, and prior sessions.
Create a separate Git worktree for each task so agents can work in parallel without changing the same checkout.
Manage terminals, Git changes, files, rules, skills, session status, and layouts from one app.
Xirp can run general sessions without a project and project sessions against folders on your Mac. Portal is not required for local projects, persistent terminals, Git worktrees, files, rules, skills, or grid view. Xirp does not replace your coding agent or source control provider. You continue to authenticate and configure each coding agent through its native CLI.## Add Portal features
Connecting Portal adds shared organizational context and catalog-based workflows:- Portal holds context in the Software Catalog and Workspaces. - Xirp runs coding agents against repositories on your Mac. - A session launched from a catalog entity or Portal Workspace can receive relevant context through MCP. - You can upload a completed Workspace session for teammates and future agents.
Install the app, sign in, complete the welcome tour, and start your first session.
Optionally link Xirp to Portal for catalog and Workspace context.
Add local repositories and work safely with Git worktrees.
Build shared context and launch informed coding sessions from Portal.