SaaS quickstart#

1. 1

   Create an account

   Sign up at /signup using GitHub OAuth or email and password.
2. 2

   Connect your repository

   Install the Kontrua GitHub App on your organisation or personal account, or add a GitLab Personal Access Token. Kontrua syncs your accessible repositories automatically.
3. 3

   Review your context settings

   Context artifacts are on by default: AGENTS.md, a codemap (docs/CODEMAP.md), and conventions (docs/CONVENTIONS.md); machine-readable architecture facts are opt-in. Choose which doc views to maintain alongside them (README, API reference, architecture, changelog), set output paths, and pick templates.
4. 4

   Approve a pull request

   Approve (or merge) a PR on your watch branch. Kontrua receives the webhook, traces the diff, and opens a context PR within minutes - review and merge it like any other change.

CLI quickstart#

1. 1

   Install the CLI

   Run npm install -g kontrua to install globally.
2. 2

   Initialize your repo

   Run cd your-repo && kontrua init to scaffold a .kontrua.yml config and install git hooks.
3. 3

   Set your API key

   Export your Anthropic key: export ANTHROPIC_API_KEY=sk-ant-...
4. 4

   Generate docs

   Run kontrua update to read recent git changes and update your documentation.