Get started

Your first project

Add a repository, open a worktree, launch an agent and read the sidebar.

Add a project

Open Sirio and add a git repository from the sidebar. Sirio reads its worktrees, including the checkout itself and any created with git worktree add, and lists one row per branch under the project name.

Open a worktree

Select a row. The centre column shows that worktree’s tabs; the first is a terminal already in the worktree’s directory. A worktree stays mounted once opened: its terminals and the processes in them keep running when you select another row, and come back when you return.

Launch an agent

Use the agent picker on the terminal tab, or type the CLI’s command. When Sirio launches an agent, it writes hook configuration only inside the worktree, so the agent can report its state back over the control socket. Your global ~/.claude, ~/.codex and similar files stay untouched.

Read the sidebar

Each row carries a dot and a word:

• running: the agent is working.
• needs input: it asked a question or is waiting for a permission.
• idle: the agent is at its prompt, or no agent is running.

Rows sort by urgency, so a worktree that needs you rises to the top. The same states drive the tray roster and desktop notifications; see Activity states.