Add a project
A project is a git repository you’ve added to ket. Everything else, worktrees, agents and terminals, hangs off a project.
Add the repository
Section titled “Add the repository”Use any of these to open the Add project dialog:
- Add Project on the start screen.
- The folder icon with the + in the sidebar’s Projects strip.
- Add project at the foot of the sidebar.
- Register the repository containing a path in the command palette (⌘K).
In the dialog, click Choose… and pick the repository’s folder. ket fills in the name and base branch. You can also set the icon, colour, agent and command before you click Add project.
The folder has to be inside a git repository, and any subfolder of one works. ket refuses a folder that isn’t in a repository. If the project is already in the sidebar, the dialog says so.
What you see next
Section titled “What you see next”The project appears in the sidebar with its first row selected. That row is the repository’s own checkout, labelled primary. It’s the folder you picked, not a new worktree.
Selecting a row that has no terminal yet opens a session in it. ket uses that worktree’s agent if it has one, and otherwise your default agent (set in Settings, ⌘,). With the default set to Auto, that’s the first installed agent in alphabetical order. Set the default to No agent if you’d rather get a plain shell.
Around the window
Section titled “Around the window”- Sidebar, on the left: your projects and their worktrees, each with a state word such as running or waiting. ⌘\ toggles it.
- Header, across the top: how many agents are running and waiting across all projects, the selected worktree’s changes, what’s ready to merge, and your agents’ plan usage.
- Tabs, in the middle: terminals, agent sessions, files, diffs and browser tabs for the selected worktree.
- Right panel: Files, Search and Git views. ⌘J toggles it.
Next, give a task its own branch: Your first worktree.