A native macOS terminal designed for managing complex AI coding agent workflows, agterm addresses the challenge of tracking numerous long-lived sessions by organizing them into named workspaces. It targets engineers and power users who benefit from a structured approach to concurrent project management, offering enhanced organization and focus over traditional tabbed interfaces.

How It Works

agterm employs a workspace-centric model, grouping related terminal sessions under distinct project contexts. Core functionality is exposed via a comprehensive control API and command-line tool (agtermctl), enabling programmatic control over session lifecycle, window management, and text injection. The application embeds Ghostty's rendering engine for robust terminal emulation, while its unique organizational features and scripting capabilities are built atop this foundation. This approach allows for deep automation and integration with AI agents, facilitating complex, multi-session workflows.

Quick Start & Requirements

• Installation: Pre-built releases are available for Apple Silicon Macs running macOS 14 or later. Alternatively, install via Homebrew: brew install --cask umputun/apps/agterm. Direct downloads from the releases page are also supported.
• Prerequisites: macOS 14 or later is required. Building from source necessitates Xcode 26+, xcodegen, and Homebrew with zig@0.15.
• Links: agterm.com, Documentation, Command reference.

Highlighted Details

• Workspaces: Sessions are logically grouped into named workspaces for better project organization.
• Control API & CLI (agtermctl): Enables extensive scripting and automation of terminal operations, session management, and agent interactions.
• Agent Integration: Supports "Agent Skills" and "Status Hooks" for AI agents (e.g., Claude Code, Codex) to interact with and report their state within agterm.
• Advanced Terminal Features: Includes split panes, scratch terminals, and overlays for running auxiliary programs without disrupting the main shell.
• Scriptable Workflow: Almost every aspect of agterm is controllable via its API, allowing users to build custom workflows.

Maintenance & Community

The README does not specify details regarding maintainers, sponsorships, or community channels like Discord/Slack. Users are directed to open issues for bugs and use GitHub Discussions for feature requests and questions.

Licensing & Compatibility

• License: MIT License.
• Compatibility: The MIT license generally permits commercial use and integration with closed-source projects without significant restrictions.

Limitations & Caveats

Restored sessions do not reattach to live processes; they respawn shells, with only single-process commands reliably restoring their state. Working directory persistence relies on shell integration and is not saved on every cd command, potentially losing recent changes on crash. The control API is designed for personal scripting and lacks terminal output streaming or event subscription. Pre-built releases are specific to Apple Silicon Macs.