Think of Marcus as a smart project manager that helps AI workers build software together. It's like having a teacher who assigns homework to different students based on what they're good at!
Marcus helps AI workers (like Claude) work together on coding projects by:
- 📋 Giving out tasks - Like a teacher assigning homework
- 👀 Watching progress - Making sure work gets done
- 🧩 Sharing knowledge - Telling workers what others have built
- 🚧 Solving problems - Helping when workers get stuck
# 1. Download Marcus
git clone <this-repo>
cd pm-agent
# 2. Start it up
./start.sh
# 3. Add your API keys
nano .env # (or open .env in any text editor)
# 4. Restart with your settings
docker-compose restartThat's it! Marcus is now running.
- Getting Started - Your first time? Start here!
- How It Works - Simple explanation of Marcus
- Installation Guide - Detailed setup instructions
- Choosing Your Task Board - GitHub, Linear, or Planka?
- Configuration - All the settings explained
- Quick Commands - Common commands reference
- Deployment Options - Local vs Remote hosting
- Troubleshooting - When things go wrong
- Architecture - How Marcus is built
- API Reference - For developers
- Contributing - Help make Marcus better!
./start.sh # Basic mode (recommended)
./start.sh demo # See it work with fake workers
./start.sh full # With visual dashboard
./start.sh remote # For hosting onlineMarcus works with different task boards (like different brands of notebooks):
| Task Board | Good For | Cost | Setup Time |
|---|---|---|---|
| GitHub | Most people | Free | 2 minutes |
| Linear | Companies | Paid | 3 minutes |
| Planka | Home use only | Free | 5 minutes |
- Planka can only be used on your own computer (not online) due to licensing rules
- GitHub is recommended for most users - it's free and powerful
- You need API keys (like passwords) for the AI features to work
- Check Troubleshooting
- Look at Common Questions
- Open an issue on GitHub
Marcus is open source (MIT License) - you can use it for anything!
🥔 Made with ❤️ in Boise, Idaho