Kotoba

Where to start

What Kotoba isWho she is and where she runs, in one page
InstallingOne package, two commands
First runA key, a model, her first words
The approval gateHow she asks before she acts
The two voice modesLocal voice, or the agent tunnel
The soul fileChange who she is
RoadmapWhat grows next, and what was cut on purpose

Or a section

↑↓ move openesc close124 pages
All pages

Documentationsection 2 of 13

The agent

15 pages, in reading order

  1. 1The two modes

    Kotoba runs one agentic loop. It runs in one of two modes, and the mode decides three things: which tools she is offered, how many times she may call them…

  2. 2How a turn works

    One turn is one call into the agentic loop. Inside it the loop iterates: ask the model, run whatever tools it called, feed the results back, ask again. It…

  3. 3Every tool she has

    40 tools across 13 toolsets. Enumerated from the live registry.

  4. 4Core tools

    Seven tools in the core toolset. They are the ones that talk to you rather than to a machine: starting and stopping a job, asking a question, putting a card…

  5. 5Web: search and reading a page

    Two tools, and they are not interchangeable. One asks the provider a question; the other fetches one URL you already have.

  6. 6Memory

    Five tools in the memory toolset, and three separate stores behind them. All three live on your disk as files or rows you can open, edit and delete.

  7. 7Files

    Four tools in the file toolset: read_file, write_file, patch, search_files.

  8. 8Terminal and code

    Two tools, two toolsets, one gate: shell (terminal) and execute_code (code). These are the only two tools routed through the ApprovalGate. (Four others put a…

  9. 9Reminders

    One tool, cronjob, in the cron toolset. It creates, lists, cancels and skips reminders.

  10. 10Reports

    One tool, make_report, in the report toolset.

  11. 11Subagents

    One tool, delegate, in the subagent toolset. Work mode only.

  12. 12The browser, and typing a password into it

    Three tools in the browser toolset: ask_secret, request_credential, get_credential. Work mode only. The first two block waiting for you to type, which a voice…

  13. 13Skills

    A skill is a Markdown file. Not code, not a plugin — a document she reads when the job matches it.

  14. 14MCP servers

    Three tools in the mcp toolset — mcp_install, mcp_find, activate_tools — plus everything a connected server exposes. All work mode only.

  15. 15Discord tools

    Nine tools in the discord toolset. Every one of them answers its availability check with the same question — "is the Discord runtime live" — and that flag is…