Contributing and reference

Kotoba is two programs in one repository: a Python package under api/, and a Next.js frontend at the root. You need Python for the first. You need Node only…

There are two suites and one typecheck. All three were run while writing this page, and the numbers below are what they printed.

These are the conventions the repository actually holds itself to. Some are enforced by a test; those say which one. The rest are enforced at review, and this…

A tool is one Python module. It declares a schema, says which family it belongs to and how risky it is, provides execute, and gets named in a list. There is…

A skill is a Markdown file, not code. It is guidance the model pulls up when a task calls for it — a playbook rather than a capability.…

pip install kotoba-companion gives you a working web app without Node ever being on the machine. That works because the compiled frontend is copied inside the…

Triggered on a push to main and on every pull request. Permissions are contents: read and nothing else. Runs of the same ref cancel each other.

Kotoba is MIT. The full text is in LICENSE, and the copyright line reads Copyright (c) 2026 Kotoba contributors.

Version 0.10 is the first release: she runs on your machine, talks, and does things. This page is the honest list of what she cannot do yet, and the shorter…

One place

Only questions the code can answer. Each one names where the answer comes from.

Four channels, and which one you want depends entirely on what kind of problem it is.