Skip to content

Projects

A project is a git repository you’ve added to ket. ket names it after the repository’s folder and works out its base branch: origin/HEAD if there is one, then main or master, then whatever branch is checked out.

Projects are listed most recently used first until you drag their headings into your own order. Each project shows a badge (the first letter of its name on its colour) and its worktrees underneath.

The first row under every project is the primary row: the repository’s own checkout, where you added it from. Merges land here. You can’t rename, pin, delete or set Economy on the primary row.

A toggle at the top of the sidebar switches between grouping rows by project and sorting every worktree by status. The filter above it shows All, Running, Waiting or Idle rows.

Right-click the project’s name and choose Project Settings… to change:

  • Display name and icon (an emoji or a short label).
  • Colour, from 18 swatches or any hex colour.
  • Default base branch, the branch new worktrees start from and merges go into.
  • Preferred agent, which new worktrees in this project start with.
  • Command, the command this project’s agent starts with.
  • Automation, whether the hooks and post-provisioning command in the repository’s .ket.toml may run.
  • Whether to show worktrees ket didn’t create.

The same menu has New Worktree, Backlog, how much disk the project takes and what Economy saved it, Hide non-ket worktrees (or Show hidden worktrees), and Remove Project.

If the repository already has worktrees you made with git worktree add, ket hides them by default. Show them from the project’s right-click menu. Clicking one adopts it, and ket treats it like its own from then on.

Remove Project asks first. ket then removes the worktrees it created, one at a time and never by force, so a worktree with uncommitted work stops the removal until you deal with it. Finally it forgets the project. The repository itself, and the primary checkout, are left exactly as they were.

If you move or delete a repository outside ket, the project stays in the sidebar marked unavailable.