Glossary

Agent — A model-backed worker that reads a workspace, runs tools, and produces diffs, commands, or structured output.

Workspace — The project folder you launch Optamus in, plus its context. Sessions and runs are scoped to it.

Run — One unit of agent work, from prompt to result, as shown in the session transcript.

Session — A local transcript of a workspace conversation, appended to ~/.optamus/sessions.

Surface — Where you work with the agent: Desktop, CLI, or Web (in development), plus the OpenAI-compatible API.

Permission — A checkpoint that gates tool use, such as file edits or shell commands.

Diff — Proposed file changes from a run, held for review before anything is written.

Engine — The backend that streams agent output. The CLI ships with an offline mock engine and a live claude-raw engine.