Configuration and operations

Kotoba has exactly seventeen settings you can change while it is running. They are not a loose collection of environment variables — they are one table in the…

Every variable on this page has a reader in the code. It was compiled by finding the call sites, not by reading the example files — an .env.example is…

Kotoba ships descriptors for exactly two: openai and xai. Those are the only values provider accepts, and the only two entries in the code's provider table.

Kotoba keeps its state in one directory — ~/.kotoba — and the code resolves that directory in one place, on purpose. Five modules once counted parents[N] by…

~/.kotoba/files is where every file Kotoba creates or edits ends up, and — this is the part that matters — it is also her working directory. There is no…

One command, one Ctrl+C, two processes at most. Three arguments do anything

There is also a memory_facts table in the database. It is legacy: at every startup its rows are folded into the markdown store, non-destructively and once…

There is no kotoba upgrade command. The subcommands are setup, doctor, serve and discord, and upgrading is your package manager's job.

There are three sinks, and which one you get depends on how you started Kotoba.