Documentation
Understand what your coding agent changed, why it chose the approach, and how the result was checked. Shaka presents the context you need to approve a change, request revisions, or resolve an open question. You choose who merges it.

Humans steer the outer loop. Agents build, test, and review inside it. At the checkpoint, evaluate the result and decide what happens next.
Start here
- Install Shaka, configure your repository, and run a first task.
- Work with Shaka: choose a merge policy, give feedback, and resume unfinished work.
- Use the practical tips or FAQ when you want to plan first, pick settings, or understand a pause.
Set up when you need to
Ask the agent to handle configuration. These guides explain your choices:
- Repository setup — reuse your checks and review the setup PR.
- Choose your settings — common choices and prompts for your agent.
- Coding agents — invocation and installation for your environment.
- Install Shaka manually — review and run the installer yourself.
- Upgrade an installation — preserve customizations when updating.
Look deeper
- PR verification — evaluate a change and revisit its decisions after merging.
- What to expect from Shaka — setup choices, verification gaps, and recovery.
- Settings reference — exact options, defaults, and advanced behavior.
- Writing preferences — choose how the agent writes for your project.
- Workflow and enforcement — what code checks and what relies on the agent.
- Architecture — why Shaka keeps one owner and little state.
- Repository catalog — organize repositories across projects.
- Control towers — coordinate a batch across chats and decide which PRs to merge first.
- Try a Shaka PR — evaluate an unmerged change on real work.
Development guidance lives in Contributing.