Projects

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. Open the Projects tab in the sessions panel.
2. Select Add Project.
3. Enter an absolute folder path.
4. Optionally enter a display name.
5. Select Add.

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.

​

Project overview

The overview shows active and recent sessions, worktrees, and a prompt box for starting work. Use the search field to filter session history by name, goal, branch, or last message. 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. 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. Markdown files with Mermaid code blocks show the rendered diagram. 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.

​

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.

​

Manage projects

From the Projects page you can:

• Pin frequently used projects
• Rename a project’s display name
• Remove a project from Xirp
• Import 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.

​

Manage worktrees

Filter worktrees by branch name, folder name, or active session name when the list is long. Projects with more than one worktree show a Cleanup button. Cleanup finds stale worktrees and shows each one’s age, whether its branch is merged, whether it has uncommitted work, and which sessions it would close. Nothing is deleted until you confirm.