Codesu

Codesu

**A desktop cockpit for running many Claude Code agents at once.**

Codesu wraps the [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI in a native desktop app so you can spin up multiple agents across your projects, watch what each one is doing at a glance, and organize the work with a built-in kanban board, notes, and activity history — all backed by real terminals.

**Status:** early release · **v0.1.0** · **License:** MIT

---

Contents

• Why Codesu?
• Features
• Tech stack
• Download & install (macOS) — for users
• Using Codesu (first run)
• Getting started (build from source) — for developers
• Keyboard shortcuts
• Project structure
• How it works
• Your data & backups
• Troubleshooting
• Recommended IDE setup
• Contributing
• License

---

Why Codesu?

Running Claude Code in a single terminal is fine for one task. But the moment you're juggling several agents — one refactoring the backend, one writing docs, one chasing a bug — plain terminal tabs stop scaling. You lose track of which agent is *working*, which is *waiting on you*, and which just *finished*.

Codesu solves that by:

• Giving every agent its own persistent, resumable terminal session.
• Automatically detecting each agent's state by reading Claude's own output — so blocked and finished agents float to the top and chime for your attention.
• Grouping agents into color-coded workspaces (folders or git worktrees).
• Layering tasks, notes, and daily activity tracking on top, so the surrounding project management lives in the same window.

---

Features