Skip to content

yunxin/agent-term

Repository files navigation

AgentTerm

Graphical terminals for steering a fleet of coding agents — integrated with your OS and IDE.

AgentTerm – filter your sessions and pick the right one

Run any CLI coding agent (Claude Code, Codex, …). The agents got good fast; the terminal you run them in didn't. Once you've got several going, it's a row of identical terminals and no idea which one needs you. AgentTerm fixes that: find the right one fast, then steer it precisely, at ease.

Find the right session

Run many agents and AgentTerm tracks them at two levels. The ones you're actively juggling become Windows taskbar buttons — each with a live thumbnail and a full-window live preview (rendered to show what the session's working on, not an unreadable shrunk-down window) and a working indicator — so you grab the one that needs you at a glance, without switching windows. The ones you've stepped away from are a keystroke away: open the picker, filter your past sessions by name, and resume any of them (the hero above). No hunting through look-alike terminals — whether you're going back to adjust an instruction you've now watched run, or to verify what an agent did.

your active agent sessions — each a live taskbar button with a thumbnail preview

(Same job, from anywhere → see "Watch and steer from your phone" below.)

Confirm what it tells you — no copy-paste

Agents explain themselves by quoting file:lines and symbols. Click any reference the agent mentions — not just files it edited — and your IDE jumps to that exact line so you can verify the claim. Tracebacks and URLs too; images/PDFs/CSVs open in their app.

click a reference → your IDE jumps to that exact line

Look without breaking it

Your IDE editor stays read-only by default, so a stray keystroke can't fat-finger an edit into the agent's code while you read it. (Flip a setting on the rare occasion you want to edit directly.)

Watch and steer from your phone

Add the companion viewer (agent-stream-hub) to your phone's home screen as a web app. It shows which agents need you across all your machines ("your turn"), drills into any live session, and lets you steer it precisely — type a reply (dictation works) or drive its menus key-by-key with on-screen esc/tab/arrow keys — even from a network that only allows outbound HTTPS.

which machines have agents waiting on you — 'your turn'   the sessions on a machine, color-coded by agent   open a live session and reply from your phone

Plus the quality-of-life stuff

Paste images and drag-drop files straight into a prompt · fuzzy-search the whole scrollback · click a resource path (.png, .pdf, .csv, …) to open it in your OS default app · right-click to quote a selection into the prompt. Ctrl+K / Cmd+K inserts your IDE's current location into the prompt.

Platform

Runs on macOS and Windows — I build AgentTerm on a Mac and use it for work on Windows, so both are first-class. Session-picking works on both: on Windows it's surfaced in the native taskbar, on macOS via an in-app picker (macOS has no equivalent taskbar — a native one is open for anyone who wants to build it). IDE navigation targets JetBrains today, but the protocol's open, so other editors and code viewers are easy to add. PRs welcome on both fronts. All MIT, all free — no telemetry, no upsell.

Install

  • Windows: download the installer (AgentTerm-x.x.x-setup.exe) from the Releases page.
  • Any platform (from source): git clone https://github.com/yunxin/agent-term && cd agent-term && npm install && npm run start
  • IDE plugins (for click-to-IDE): grab the intellij-navigator zips from Releases and install via Settings → Plugins → ⚙ → Install Plugin from Disk — both locally, or (for JetBrains Remote Dev) the backend plugin on the host and the frontend on the client. Repo: yunxin/intellij-navigator.
  • Phone/web viewer: self-host agent-stream-hub and add it to your home screen.

How it works (for the curious)

  • Append-only, single-pass decoration engine — pattern detection runs incrementally on new output (O(new rows), not O(total)), so thousands of live links cost ~nothing as the stream grows.
  • Open IDE protocol — navigation is newline-delimited JSON over a local TCP socket (a backend plugin resolves files/symbols + moves the caret on 8765; a frontend plugin scrolls the viewport + reports the caret on 8766). Any editor can implement it — see the API spec. JetBrains today; VS Code / Neovim / Emacs welcome.
  • Cross-platform shell — WSL on Windows, native PTY on macOS.

Part of the AgentTerm suite

Built with Electron · xterm.js (WebGL) · node-pty · esbuild. MIT licensed. If it resonates, a ⭐ helps others find it.

About

Graphical terminals for steering a fleet of coding agents — integrated with your OS and IDE

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages