> ## Documentation Index
> Fetch the complete documentation index at: https://backstage.spotify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Xirp

> Run and manage local AI coding sessions across projects, agents, and Git worktrees.

Xirp is a macOS desktop app for running AI coding agents across multiple projects and sessions. Use it on its own to manage local coding work, or connect Spotify Portal to add catalog and Workspace context.

<img src="https://mintcdn.com/spotify-89f50c35/Au6-kNeho5Rk8Vno/xirp/assets/xirp-home.webp?fit=max&auto=format&n=Au6-kNeho5Rk8Vno&q=85&s=677c225d8a59348810145f5ec2890674" alt="The Xirp home screen" width="1800" height="1153" data-path="xirp/assets/xirp-home.webp" />

<Warning>
  Xirp is currently in beta. Features and screens may change quickly. Report
  unexpected behavior through the support channel provided with your beta
  invitation.
</Warning>

## What Xirp provides

<CardGroup cols={2}>
  <Card title="Parallel coding sessions" icon="terminal">
    Run Claude Code, Codex, or Gemini in persistent terminal sessions and switch
    between them without losing state.
  </Card>

  <Card title="Optional Portal context" icon="brain">
    Connect Spotify Portal to give agents access to Workspace wiki pages,
    catalog entities, resources, records, members, and prior sessions.
  </Card>

  <Card title="Project isolation" icon="code-branch">
    Create a separate Git worktree for each task so agents can work in parallel
    without changing the same checkout.
  </Card>

  <Card title="One control surface" icon="grid-2">
    Manage terminals, Git changes, files, rules, skills, session status, and
    layouts from one app.
  </Card>
</CardGroup>

## Use Xirp on its own

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:

1. Portal holds context in the Software Catalog and Workspaces.
2. Xirp runs coding agents against repositories on your Mac.
3. A session launched from a catalog entity or Portal Workspace can receive relevant context through MCP.
4. You can upload a completed Workspace session for teammates and future agents.

Portal administrators configure the GitHub connection used for catalog ingestion and repository discovery.

## Current beta scope

* macOS only
* Claude Code, Codex, and Gemini coding agents
* Optional Portal connection for catalog and Workspace features
* Manual session upload for Workspace-launched sessions

## Start here

<CardGroup cols={2}>
  <Card title="Set up Xirp" icon="rocket" href="/docs/xirp/getting-started">
    Install the app, sign in, complete the welcome tour, and start your first
    session.
  </Card>

  <Card title="Add Portal features" icon="link" href="/docs/xirp/xirp-and-portal">
    Optionally link Xirp to Portal for catalog and Workspace context.
  </Card>

  <Card title="Use projects" icon="folder" href="/docs/xirp/projects">
    Add local repositories and work safely with Git worktrees.
  </Card>

  <Card title="Use Workspaces" icon="book-open" href="/docs/xirp/workspaces">
    Build shared context and launch informed coding sessions from Portal.
  </Card>
</CardGroup>