agterm

Drive agterm, a native macOS terminal app, programmatically via its agtermctl CLI and a local control socket. Use when running inside an agterm session and asked to control the terminal: create, rename, close, select, or reorder sessions and workspaces; split panes; toggle the per-session scratch terminal; open or close overlay terminals and read their exit status; display an image inline via a bundled helper script; type into a session, copy its selection, or search its scrollback; post desktop notifications; manage windows (new, list, select, close, resize, move); change font size; or reload and edit the keymap and the agterm-scoped ghostty config. Also covers the window/workspace/session addressing model and the AGTERM_* environment a spawned shell sees, plus subscribe to status, notification, session lifecycle, and tree-change events; diagnose problems (keymap editor, custom actions, logs); and file a bug as a GitHub issue or a feature request / question as a GitHub Discussion.