Use Kite
Use Kite instead of manual staging and WIP commits when the repository's workflow is built around kt.
Workflow
- Inspect the repository before acting.
- Run
git status --short --branch. - If the task involves landing or undoing, also run
git log --oneline -n 12. - Check whether
ktis available withcommand -v kt. If it is not, prefercargo run -- ...inside the Kite source repo orcargo install --path .when installation is appropriate.
- Choose the command that matches the user's intent.
- Use
kt go <name>to start a new flow branch. - Use
ktto quicksave tracked and untracked changes without hooks. - Use
kt landto rewrite contiguous Kite saves into grouped commits. - Use
kt undoonly when the user explicitly wants to reverse a previous land.
- Treat history-rewriting commands as high-impact.
kt landrewrites recent Kite save history and may force-push.kt undoperforms a hard reset and may force-push.- If the user asked you to "use Kite" but did not explicitly ask for history rewriting, explain the effect before running
kt landorkt undo.
Operating Rules
- Prefer Kite commands over manual
git addplus throwaway commits when the repo is actively using Kite. - Before
kt land, confirm the feature is ready and report whether a remote push is likely. - If landing falls back to manual mode, provide a strict Conventional Commit message.
- If a landed commit is blocked by hooks, leave the staged changes intact and help fix the hook failure.
- After running any Kite command, summarize what changed in the worktree, branch, and remote state.
Reference
Read references/cli-behavior.md when you need exact command semantics, environment variable names, or current implementation caveats.