Terminal
Interactive workspace terminals, visible command runs, input requests, and durable command history.
The CompozyOS terminal is a daemon-owned workspace terminal. Operators can open it in the OS shell
or CLI, agents can use the compozy__terminal_* toolset when work should be visible, and both paths
can interact with the same terminal concurrently under the same profile, approval rules, and command
journal.
Use the terminal for work that benefits from supervision: an interactive prompt, a long-running server, a full-screen program, or a command the operator asked to watch. Routine commands that an agent runs inside its own provider session remain session activity and do not create CompozyOS terminal journal rows.
Choose a path
| Goal | Start here |
|---|---|
| Open a terminal and run a visible command | Tutorial |
| Decide when an agent should use terminal tools | Agents and safety |
| Audit commands or opt in to a replayable recording | Journal and recordings |
| Understand profile ownership and archive behavior | Profile segmentation |
| Check interactive support before opening a terminal | Platform support |
The generated Terminal CLI reference owns the complete command and flag list. HTTP and UDS expose the same daemon handlers for browser, desktop, CLI, and local integration clients.