agent-of-empires

🥈Silver

Agent of Empires automates coding tasks via terminal sessions. It connects Claude Code, OpenCode, and Mistral Vibe to CLI tools like Codex and Gemini. Operations teams use it to manage git worktrees and tmux sessions, streamlining development workflows.

1,424220Updated 6d ago

Intermediate30min to implementautomation

Saves ~45 min per use

Quick InstallView Source

git clone https://github.com/njbrake/agent-of-empires.git

Works with:

Claude

Overview

About This Skill

https://njbrake.github.io/agent-of-empires/

How to Use

1. **Install Dependencies**: Ensure git, tmux, and your preferred CLI tools (Codex/Gemini) are installed. Configure Agent of Empires with your preferred editor paths. 2. **Prepare Worktree**: Create a base directory for worktrees (e.g., `~/code/worktrees`) and ensure it's empty. This prevents conflicts between branches. 3. **Run Automation**: Paste the generated commands into your terminal. For complex setups, use `tmux attach -t [SESSION_NAME]` to monitor progress in real-time. 4. **Verify Environment**: Check the output of each pane. Confirm the correct branch is checked out and services are running (e.g., dev server, test runner). 5. **Begin Development**: Use the tmux panes for parallel tasks. Edit code in the editor pane, run tests in the test pane, and debug in the debugger pane. Commit changes directly to the worktree.

Use Cases

Manage multiple AI coding sessions simultaneously using tmux.

Easily switch between different coding environments with the TUI dashboard.

Isolate project environments by sandboxing agents in Docker containers.

Organize coding sessions into hierarchical groups for better project management.

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/njbrake/agent-of-empires

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Automate the setup of a new feature branch for [PROJECT_NAME] using Agent of Empires. Create a git worktree in [WORKTREE_PATH] pointing to [SOURCE_BRANCH], then launch a tmux session named '[SESSION_NAME]' with panes for [EDITOR], [TEST_RUNNER], and [DEBUGGER]. Execute the command to switch to the new branch and verify the environment. Provide the exact commands and expected output.

Example Output

### Agent of Empires Automation Report

**Task:** Automate setup of `feature/payment-integration` for `acme-ecommerce`

**Commands Executed:**
```bash
# Create worktree
git worktree add -b feature/payment-integration /tmp/acme-ecommerce-feature-payment-integration main

# Launch tmux session
tmux new-session -d -s payment_dev

# Split panes and execute commands
tmux send-keys -t payment_dev:0.0 'cd /tmp/acme-ecommerce-feature-payment-integration' C-m

tmux send-keys -t payment_dev:0.1 'npm run dev' C-m

tmux send-keys -t payment_dev:0.2 'npm run test:watch' C-m

# Switch to new branch
tmux send-keys -t payment_dev:0.0 'git checkout feature/payment-integration' C-m
```

**Environment Verification:**
```
$ git branch
  feature/payment-integration
* main

$ npm run dev
  [PAYMENT_SERVICE] Listening on port 3001
  [DB] Connected to staging cluster

$ npm run test:watch
  Test Suites: 12 passed, 2 skipped
  Coverage: 87%
```

**Next Steps:**
1. Open VS Code in the worktree directory
2. Push initial commit: `git push -u origin feature/payment-integration`
3. Create PR with template from .github/PULL_REQUEST_TEMPLATE.md

All systems operational. Ready for development.