Agman: A TUI-based Orchestration Tool for AI Coding Agents, Using Git Worktrees for Task Isolation

Agman is a Terminal User Interface (TUI) tool designed specifically for managing AI coding agents like Claude Code. It corely addresses challenges in AI-assisted programming such as multi-task management, context contamination, supervision control, and Git/CI/CD integration. It achieves full task-level isolation via Git worktrees and tmux sessions, supporting multi-agent parallel development, automated PR workflows, and YAML-defined workflow orchestration, providing enterprise-level orchestration and management capabilities for AI coding agents.

With the popularity of AI programming assistants like Claude Code and GitHub Copilot, AI has become a coding agent that can independently perform complex tasks, but it brings new management challenges:

1. How to manage multiple AI-driven development tasks simultaneously?
2. How to avoid context contamination between different tasks?
3. How to maintain supervision control when AI executes autonomously?
4. How to integrate AI workflows into existing Git and CI/CD processes? Agman (Agent Manager), built on Rust and ratatui, aims to address these issues.

1:1:1 Task Isolation Model

Each AI task corresponds to one Git branch, one Git worktree, and one tmux session, achieving full isolation. The advantages include no context switching cost, support for parallel development, clear task boundaries, and a safe experimental environment.

Core Features

• Task Management: Interactive creation wizard, status tracking, feedback mechanism, restart recovery;
• Agent Orchestration: YAML-defined workflows, supporting reusable templates, auditability, extensibility, and conditional control;
• Git Worktree Integration: Automatic worktree/branch management, support for branch strategies, change tracking;
• Tmux Integration: Exclusive session for each task, including windows for nvim, lazygit, claude, etc.;
• GitHub Integration: Automated PR operations (draft PR, CI monitoring, review tracking, etc.) and pre-packaged workflows.

Agman chooses Rust as its implementation language, paired with the ratatui framework to build the TUI:

• Rust Advantages: Zero-cost abstractions, memory safety ensuring performance and reliability, rich CLI ecosystem accelerating development;
• ratatui Framework: Declarative UI components, efficient terminal rendering, keyboard-driven interaction, cross-platform compatibility;
• Interaction Design: Drawing on Vim philosophy, fully keyboard-operated, with preview panels, built-in editor, and shortcuts forming an efficient workflow.

Agman has a security warning: "Agman is reckless by design". All Claude Agents run in the --dangerously-skip-permissions mode, allowing AI to directly read/write files and execute commands. This design aims to maximize AI autonomy in a controlled isolated environment, with Git worktree isolation providing a security boundary (errors only affect the current task directory). However, it is not suitable for production environments, code repositories containing sensitive credentials, or scenarios where data loss cannot be tolerated. Developers should understand the security model before using it.

Agman is suitable for various AI-assisted development scenarios:

• Parallel Feature Development: Multi-task parallelism shortens cycles;
• Code Refactoring: Decomposing large tasks reduces risks;
• Test-Driven Development: Automatically executing the "test-implement-fix" cycle;
• Code Review Assistance: AI helps analyze PR issues;
• Exploratory Programming: Trying new solutions in an isolated environment, discard if not satisfied.

Current Limitations

• Platform Restrictions: Only supports macOS; Linux is theoretically usable but untested; Windows is not supported;
• Security Model: Reckless mode has risks and is not suitable for all scenarios;
• Ecosystem Dependencies: Relies on tools like tmux and nvim, with a high configuration threshold.

Future Direction

Agman represents the evolution of AI-assisted development tools from code completion to full workflow orchestration. As AI capabilities enhance, such tools will become more important in software development.

Agman is an innovation in development tools for the AI era. Its core design philosophy is to maximize AI autonomy in an isolated environment, achieving task isolation via Git worktrees and tmux, orchestrating workflows with YAML, and providing an efficient experience through TUI. Despite platform restrictions and security constraints, it provides a reference for future AI-assisted tools. It is recommended that developers already using AI assistants like Claude Code try Agman; it may change the way you collaborate with AI, turning multiple AI agents into a virtual development team.