termiAgent

termi

A terminal Agent that works beside you — and keeps working when you leave.

termi is a terminal Agent built into your real Shell. When you do not know a command, ask termi immediately. It understands what you just did, can explain the next step, or execute the command for you without taking you out of the terminal.

termi also runs as a persistent background daemon. It can monitor services and long-running tasks around the clock, even after you detach. For larger goals, start a termi Team and let multiple Agents coordinate the work across your terminal sessions.

What makes it different

• Ask without leaving the terminal. If you do not know the command, ask termi in the workspace or use termi -q from your current Shell.
• The Shell stays a Shell. Completion, history, SSH, tmux, REPLs, and interactive programs work as usual.
• The Agent shares the scene. It follows the current cwd, commands, output, remote session, and task instead of starting from an unrelated chat.
• Monitoring never clocks out. The daemon keeps sessions, monitors, and scheduled checks running 24/7 and reports their status on a local Web board.
• Teams take on bigger goals. Activate a termi Team to coordinate multiple Agents around one terminal task goal.
• Automation remains supervised. Auto Review, sandboxing, approvals, and audit logs keep authority with the user.

Get started

termi currently supports Linux and requires Go 1.26+ and bubblewrap.

git clone https://github.com/ccq1/termiAgent.git
cd termiAgent
make build
./bin/termi

On the first run, termi opens a guided command-line setup for the Provider, model name, API key, context window, and output limit. DeepSeek, OpenAI, Anthropic, and OpenAI-compatible endpoints are supported. Run termi setup whenever you want to configure the model again, or press F2 inside the TUI.

Use termi

Work beside the Agent

Run commands on the left and talk to the Agent on the right. Press Shift+Tab to switch focus.

What did I just do?
Why did this service fail?
Monitor this service every five minutes.
Fix the configuration, but do not restart production.

If the main Shell is busy, the Agent can use a private sub-Shell for independent inspection. If you are connected through SSH, it works in that remote Shell.

Call it from any terminal

termi -q "What is using port 4000?"
termi -q "Clean safe caches in this directory"
termi -q --new "Start a fresh context"

Quick Mode follows the parent Shell's cwd and recent activity. For reliable Bash history capture:

eval "$(termi shell-hook bash)"

Monitor services around the clock

Press Ctrl+B, then D, to detach without stopping your sessions. Open http://127.0.0.1:7331 for the local operations board.

The daemon continues running managed monitors and scheduled Agent checks after you detach. The board shows active work, service health, idle sessions, and operations waiting for approval.

Activate a termi Team

Create a Goal, activate a Team, and assign multiple Agents to investigate, execute, verify, and monitor different parts of the same terminal task. Team progress remains visible from the operations board.

Highlights

• Real PTY Shell-Agent sessions
• Persistent tabs, task queues, monitoring, and soft resume
• Quick AI from an ordinary Shell
• Operations memory for hosts, services, ports, topology, and runbooks
• Goals and multi-Agent Teams
• Web search and fetch
• Auto Review and Full Access modes
• Automatic model context compression
• Chinese and English UI/output

Essential keys

Key	Action
Shift+Tab	Switch Shell / Agent
Alt+T	New session
Alt+← / Alt+→	Switch session
Alt+P	Auto Review / Full Access
Ctrl+G	Stop Agent, keep Shell running
Ctrl+B, then D	Detach
F2	Settings

Learn more

• Architecture
• Quick Mode
• Context compression
• Agent Teams and Goals
• Security

make check
make install

termi is under active development. Release builds currently target Linux amd64 and arm64.