Skip to main content
A project is a folder on your Mac that Xirp uses as the working directory for coding sessions. One project can contain many sessions.

​
Add a project

  1. Select Projects in the top navigation.
  2. Select Add Project.
  3. Enter an absolute folder path.
  4. Optionally enter a display name.
  5. Select Add.
Add Project dialog You can add:
  • A single Git repository. This enables the full Git and worktree experience.
  • A non-Git folder. Sessions, files, skills, and rules remain available.
  • A parent folder containing several repositories. Agents can work across the children, but repository-level Git and worktree controls are limited.
Registering a project does not upload its files to Portal. The coding agent and Xirp operate on the local folder.

​
Project overview

The overview shows active and recent sessions, worktrees, and a prompt box for starting work. A project with an active session Use the session view controls to switch between cards, a compact list, and other available layouts. Xirp keeps session and worktree information together so you can see which branch each agent is using.

​
Git

The Git tab shows working-tree changes, branches, commit history, and commit controls. Select a changed file to inspect its diff before committing. The Git tab A new-worktree session creates a separate branch and checkout. This lets several agents work against the same repository without modifying the same files in the same working tree.

​
Files

The Files tab provides a file tree and editor. Markdown files can be viewed as source or previewed. Editing a README in the Files tab Useful shortcuts:
  • Cmd+P: open a file by name
  • Cmd+Shift+F: search across project files
  • Cmd+E: toggle the file editor from a session

​
Skills

The Skills tab lists reusable agent instructions discovered from supported global and project skill folders. Use skills for repeatable procedures such as release checks, migrations, or repository-specific operations. The Skills tab

​
Rules

The Rules tab lists project and global instruction files such as CLAUDE.md, AGENTS.md, and supported agent configuration files. Rules help an agent follow repository conventions. The Rules tab

​
Manage projects

From the Projects page you can:
  • Pin frequently used projects
  • Rename a project’s display name
  • Remove a project from Xirp
  • Import more repositories from a parent folder
Removing a project from Xirp does not delete the local folder. Review any separate worktree cleanup prompt before confirming it.