Agron

Agron is a terminal orchestrator for running multiple concurrent AI agent sessions (Claude, Codex, Gemini) with Git worktree isolation.

Each task runs in its own Git worktree, preventing file conflicts when multiple agents work in parallel. A dual-pane TUI gives you real-time visibility into every running session and lets you respond to agent prompts immediately.

Features

• Parallel Agent Sessions — Run up to 8 concurrent AI agent processes, each in an isolated Git worktree
• Dual-Pane TUI — Left panel for orchestrator chat, right panel for monitoring process slots
• Git Worktree Isolation — Automatic worktree creation per task prevents file conflicts between agents
• Multi-Agent Support — Works with Claude, Codex, and Gemini CLI tools (auto-detected)
• Prompt Detection — Automatically detects when an agent needs user input and highlights the slot
• Chat History — SQLite-backed persistence of sessions, chat messages, and process logs
• Auto-Approve Tools — Configure tool auto-approval per agent with persistent settings
• File Mentions — Use @filename syntax to inline file contents into agent prompts

Getting Started

Requirements

• Git 2.0 or later
• At least one AI agent CLI installed: claude, codex, or gemini

Install

npm install -g agron

Verify

Run agron inside any Git repository:

cd your-project
agron

Usage

1. Navigate to a Git repository and run agron
2. Use the orchestrator chat (left panel) to create sessions and assign tasks to agents
3. Monitor running agents in the process slots (right panel)
4. When a slot shows PROMPTING, select it and type your response to interact with the agent
5. Use Tab to switch focus between panels, and keyboard shortcuts shown in the status bar for navigation

CLI Options

agron                        # Start Agron

Contributing

Contributions are welcome. Please read the Contributing Guide before submitting a pull request.

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.

Author

Sung YeIn