Repository navigation
Guides Contributing Pull Requests
Targeting, branching, conventions.
origin = cuongtranba/kanna is the only remote, and the only valid PR target.
gh repo set-default is not set, so gh pr create with no explicit target
prompts or guesses. Always pass:
gh pr create --repo cuongtranba/kanna ...
# or
gh pr create --base main --head <branch> ...to make the target explicit.
-
feat/<topic>— new features -
fix/<topic>— bug fixes -
docs/<topic>— docs-only changes -
chore/<topic>— refactors, cleanup
Conventional Commits style. Short subject, body if non-obvious.
Every push to main and every PR runs lint, the ast-grep useState gate, the
architecture budget, the complexity-ceiling check, typecheck, the client build,
the bundle check, and the test suite — plus gitleaks and semgrep as separate
workflows. Merges are blocked on any failure.
Run bun run check and bun run test locally first; see
Lint & Tests for the full list and what
each gate is for.
This wiki is generated from wiki/src/content/docs in cuongtranba/kanna.
Edit the docs there: changes made on this wiki are overwritten on the next sync.
The same docs are published at https://kanna-wiki.lowbit.link.
Getting Started
Features
- Providers & Models
- Chat & Transcript
- Generative UI
- Projects & Sessions
- Boards
- Multi-repo Stacks
- Slash Commands
- Cron Jobs
- Loops
- Beacons
- Kanna Plugins
- Package Auto-Update
- Advanced
- Security
Guides
- User Guide
- Contributing
- Ops & Self-Host
Sharing
Reference