Kitchen
kito-kitchen gives a team a kitchen: how its agents behave, what its
words mean, how things are done here, and the tools everybody has. It is
written once, kept on the team’s Kito server, and given to every agent of
every person, whatever coding assistant they use.
Who enables it, and where
Section titled “Who enables it, and where”A server, by its administrator. Each person installs it once:
kito plugin add kitchen. In a directory connected to the server there
is nothing to enable: the server did.
Starting a kitchen
Section titled “Starting a kitchen”-
The plugin, on the server’s machine:
Terminal window kito-server plugin add kitchenkito-server plugin enable kitchen --for-clients -
The files to start from, and a repository of the server made of them:
Terminal window kito-server kitchen new ./kitchen "Shopworks"kito-server repo add kitchen --from <a git repository of them>Or from any directory connected to the server:
kito repos add kitchen --push ./kitchen. -
Which repository is the kitchen, and what each repository picks:
Terminal window kito-server kitchen set kitchenkito-server kitchen parts shop rust web # what `shop` pickskito-server repo set shop --kitchen kitchen # its instructions, for `shop`kito-server kitchen show shop # what it getskito-server kitchen check # what is wrong with itIn the web client, a repository’s maintainers choose its kitchen in Settings, or from the kitchen’s own page.
-
Its text. The starter files are a short behaviour, one concept, one recipe and one instruction: examples to replace. They are written like code: in a lane of the kitchen’s repository, reviewed and integrated. In the web client, a file of the kitchen is edited in the browser, and a lane is opened for the change.
With an assistant
Section titled “With an assistant”A kitchen is Markdown in a repository, so an assistant can draft it. Connect a directory to the kitchen’s repository and ask there:
kito connect kito.example.com/kitchenAsk me how we work, one question at a time. Then write
behaviour.md, a concept for each word we use our own way, and a recipe for each thing we do in steps.
The assistant opens a lane, writes the files, and asks for the integration: what it wrote is reviewed like any change. Nothing in Kito asks the questions for you: the prompt is yours.
What it asks for
Section titled “What it asks for”permissions = ["read", "server_admin"]| Permission | What it lets the plugin do |
|---|---|
server_admin |
On a server, add kito-server kitchen |
read |
In the directories connected to the server, ask the server’s kitchen |
What a kitchen is
Section titled “What a kitchen is”A repository on the server, with these files:
kitchen.toml name = "Shopworks"behaviour.md how agents work here: always toldconcepts/<name>.md what a word of the team means: looked uprecipes/<name>.md how something is done, step by step: looked uptools/<name>.toml a command every agent has, and what it takesinstructions/all/… what every assistant is told, in its own fileinstructions/<assistant>/… the same, for one assistantparts/<part>/… the same, for the repositories that pick the part- Behaviour is short, and every agent is given all of it.
- Concepts and recipes are named. The first line of each file says what it is about; an agent is told the names and those lines, and asks for the text when it needs it.
- A tool is a command, run in the working copy of the lane the agent
works in: a
scriptthe kitchen carries or acommandthe machine has, itsargs, atimeout_secs, and the[input]it takes. What an agent gives is one word of the command, whatever is in it: no shell reads it. - A part (
parts/rust/,parts/web/) is for the repositories that pick it. A repository gets the base and its parts; a part wins over the base where both have something of the same name.
It is changed like code: a lane in the kitchen’s repository, a review, an
integration. Its instructions/ folder holds what every assistant is
told, in Kito’s standard layout: Kito writes
it into CLAUDE.md and AGENTS.md of each repository the kitchen is
attached to, at every session, so nothing goes stale there.
Using it
Section titled “Using it”People read it with kito kitchen, kito kitchen concept <name> and
kito kitchen recipe <name>; kito kitchen run <tool> --lane <lane> runs
one of its tools. Agents get four tools next to Kito’s own:
kitchen: the behaviour, and what concepts, recipes and tools there are;concept,recipe: the text of one;run: one of the kitchen’s tools, in the lane the agent works in.
When a session starts the agent is told the behaviour and the lists without asking, after Kito’s own rules. What they answer says whose words these are: the team’s instructions, to follow, and not Kito’s own rules, which stand whatever a kitchen says.
When the server cannot be reached, the kitchen is the one it last gave, and says how old it is; what was never asked for is not there to give.
Limits, and what was not tried
Section titled “Limits, and what was not tried”- Not used yet by a team, with an assistant in a real session.
- A tool runs confined to the lane where Kito can confine a command (Linux
5.13 or later): it writes only there, reads nothing of Kito’s own or of
your keys, and reaches the network only if the kitchen says the tool
needs it. It still reads the rest of your machine, and runs as you:
whoever may change the kitchen decides what runs, so give that role
accordingly and review changes to
tools/like code. - Where Kito cannot confine a command (macOS, Windows, an older Linux) a
tool is not run, and says so.
KITO_KITCHEN_UNCONFINED=1runs the kitchen’s tools as yourself there, unconfined: your call, on your machine.KITO_KITCHEN_NO_TOOLS=1turns them off altogether. A kitchen’s scripts are for a Unix shell. - Which repository is the kitchen and what each repository picks are kept
by the plugin on the server (
plugins/kitchen/config.toml), not in a repository: they have no history. - Everybody who may use a repository of the server may read the kitchen.
Version
Section titled “Version”0.4.0