Terminal
Interactive workspace terminals, visible command runs, input handoffs, 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
share the same control lease, 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.