+0
日增长
746
stars
116
forks
6
watchers
668
prs
192
issues
78
releases
README
agterm - a simply good terminal with a full control API agterm.com · Documentation · Command reference · Cookbook agterm is a native macOS terminal with a deliberately small interface and a full control API. Shells are organized into named workspaces, each holding the sessions for one project or context, and that hierarchy is the whole model: there is nothing else to learn before it is useful. Everything it holds is also an object a script can address. The bundled agtermctl creates sessions and types into them, reads a pane's text back, runs a program in an overlay and returns its exit status, sets a session's status glyph, opens the native picker, moves windows, and reads all of that state back out over a local socket. The motivation is specific: running several coding agents at once means many long-lived sessions, each progressing on its own, and a tabbed terminal loses track of them quickly. Each agent works in a named session and reports whether it is active, blocked, or done, so it is obvious which one needs you. An installable skill teaches an agent the control model, so it can drive the terminal itself. None of that is a special agent mode; it is the same control surface anything else uses. With nothing scripted at all it is a capable general-purpose terminal for everyday multi-project work. The design is deliberately minimal: it covers the use cases above and stops there. Features come in two kinds. One is just enough to get the work done. The other is the small set of things other terminals get wrong, done the way they should have been. There is no deep agent integration and no attempt to invent a new way of working with agents. You get a sensible minimum out of the box, plus a complete control API and CLI on top, so anything past the defaults you build yourself instead of waiting for it to ship. What it does: - Workspaces. Sessions are grouped under named workspaces like "work" and "personal", which keeps a screen of concurrent sessions organized. You reach a session by name, by recency, or from the keyboard. - Control API and CLI. A bundled tool, agtermctl, drives almost everything over a local socket: create sessions, type into them, run a program in an overlay and read its exit status, move and resize windows, or post a notification tied to a specific session. A script or an agent can set up and drive its own layout, and send you a notification from the session it was working in. - Splits, scratch, and overlays. Split a session into two shells side by side or top and bottom, open a scratch terminal over it, or run a program in a full or floating overlay without disturbing the shell underneath. - Companions. Keep a log tail, a watcher, a second shell, or an HTML page pinned under a session in the sidebar: companions move, fold, and close with it. Duplicate as Companion copies a session's split layout and starts another copy of each pane's program. They work on sessions attached from another Mac too. An HTML page can also be a
Top issues
#1007Remote session: asks, overlays and pages open on a Mac nobody is using once the presenter leaves or another viewer leads1 comments · 2026-11-15#1005Viewer leaving freezes the origin app: `ghostty_surface_free` waits on the main thread for sleeps whose length macOS controls1 comments · 2026-11-15#1009Plain http to a Tailscale peer IP fails ATS, but LinkPolicy and the docs count every IP literal as local0 comments · 2026-11-15#321Prepare the first stable release (v1.0.0): compatibility guarantee and slower cadence0 comments · 2026-07-29
Discussions
#1006`focus_other_pane` keymap action: switch focus between the two split panes1 comments · 2026-11-15#1003A phone companion app: watch sessions and answer agent prompts from the phone0 comments · 2026-11-15#1002Custom commands in the sidebar session context menu1 comments · 2026-11-15#998zmx attach client drops a session's last output when the session ends1 comments · 2026-11-14#994Are there plans to support `msg send` / `msg read` / `msg ack` on agterm-server?1 comments · 2026-11-14#992Floating overlay panel: anchor position, drag to move, and an option not to take keyboard focus1 comments · 2026-11-13#989Allow HTML overlays without an existing session1 comments · 2026-11-13#986Keep unreadable state files instead of overwriting them with defaults1 comments · 2026-11-13
Latest release
Version 0.42.3 v0.42.3 2026-11-14Bug Fixes - Switching to or from a left/right split session with the compact toolbar no longer flickers at the top. Every switch resized both panes by about two rows, so the shells redrew and a stale frame showed under the titlebar; the panes now keep their size. A top/bottom split can still jump its divider for one frame when shown 995 @umputun - an unnamed session on an agterm-server host, shown in a remote window, kept its directory name as the sidebar label and window title instead of following the terminal title. It follows the title once both the server and the app are updated 993 @umpu