Terminal

The terminal is Omnigent's default interface: keyboard-first, with streaming output and real-time tool execution. If you already live in a terminal, this is the fastest way to work with your agent.

Start a terminal session

The terminal interface requires tmux, so install it first if you don't have it:

# macOS
brew install tmux

# Debian / Ubuntu
apt install tmux

Then start a session by pointing Omnigent at an agent config:

omni run agent.yaml

From here, the agent streams its output as it thinks and acts. Tool calls run in real time, so you watch file writes, shell commands, and API calls land as they happen. The session also stays in sync with the Web UI both ways: run the agent in your terminal and glance at the browser whenever you want file diffs or inline comments.

When to use the terminal

The terminal shines when you want to stay close to the command line:

• Fast iteration. Keyboard-first, no context switching to a browser.
• SSH environments. Works over SSH where a browser isn't available.
• Low-bandwidth connections. Text-only, minimal overhead.
• Scripting and automation. Composable with other CLI tools.