CLI
Repo verbs
The kraft repo verbs: list, connect, and disconnect repositories, and reach their worktrees.
kraft repo manages the repositories Kraft works in and their worktrees.
kraft repo list
kraft repo connect
kraft repo disconnect
cd "$(kraft repo path <id>)"
kraft repo path --shell
kraft repo open <id>
kraft repo open <id> --editor cursor
| Command | Effect |
|---|---|
repo list | The connected repos. * marks the one you are in. --all also lists auto-connected repos nobody has touched yet. |
repo connect [PATH] | Connects a repo (safe to repeat). A relative PATH, . included, is read from where you stand. It proposes a setup command and a test command from the repo's files. Check both before you trust them. |
repo disconnect [PATH] | Forgets the repo. Work items are untouched. |
repo path [ID] | Prints the item's worktree path. repo cd is an alias. --shell prints a shell function that does the cd for you. |
repo open [ID] | Opens the worktree in an editor. --editor picks code, cursor, zed or obsidian. The default is the system's. |
For each repo's settings (setup_command, env, test_scopes and the rest),
see Configuration. You
edit them in the Settings screens or in repos.yaml, not with the CLI.