Concepts
Kosuke's vocabulary is precise. The database and the API use one set of names, the interface sometimes uses another. Both are listed here, because an agent reads the API names and a person reads the interface names.
| Term | What it is |
|---|---|
| Workspace | The unit of tenancy. Owns projects, members, AI provider credentials and spend. Called organization in the API and the database, because that is what the auth library names it. Every project belongs to exactly one. |
| Member | A user's membership of a workspace. No membership means no access to that workspace's projects. |
| Role | What a member may do: owner, admin or member. Owner and admin are both administrative. owner is held by whoever created the workspace and moves only through an ownership transfer. |
| Project | A GitHub repository a workspace has connected, plus what Kosuke needs to run it: services, environment variables, setup commands, sandbox sizing. |
| Chat session | One unit of work on a project. Owns a branch, a sandbox and a conversation, and ends as a pull request. |
| Chat job | One agent turn inside a chat session. Created when you send a message, drained by a worker, polled for status. |
| Steer | A message sent while the agent is mid-turn, folded into that turn so it changes course without restarting. Never its own chat job. |
| Sandbox | The cloud VM a project runs in. Boots from a template, can be paused and resumed, and costs money while awake. |
| Sandbox key | What routes a request to the right sandbox. A project has one for its main sandbox and one per chat session. |
| Preview | A running sandbox served on the public internet at its own subdomain, so you can click through the app the agent just changed. |
| Model | The AI configuration a session runs under: a provider, a model family, and a reasoning effort, carried as one encoded id such as anthropic:sonnet__medium. |
| Reasoning effort | The thinking budget bundled into a model. Part of the model id, not a separate setting. |
| Agent session | The coding agent's own memory of a conversation, stored on the sandbox and resumed on the next turn. Distinct from the chat session. |