Documentationsection 2 of 13
The agent
- 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…
- 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…
- 3Every tool she has
40 tools across 13 toolsets. Enumerated from the live registry.
- 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…
- 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.
- 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.
- 7Files
Four tools in the file toolset: read_file, write_file, patch, search_files.
- 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…
- 9Reminders
One tool, cronjob, in the cron toolset. It creates, lists, cancels and skips reminders.
- 10Reports
One tool, make_report, in the report toolset.
- 11Subagents
One tool, delegate, in the subagent toolset. Work mode only.
- 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…
- 13Skills
A skill is a Markdown file. Not code, not a plugin — a document she reads when the job matches it.
- 14MCP servers
Three tools in the mcp toolset — mcp_install, mcp_find, activate_tools — plus everything a connected server exposes. All work mode only.
- 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…
