agent-ecosystem/README.md

Claude Agent Teams UI

You're the CTO, agents are your team. They handle tasks themselves, message each other, review each other's code. You just look at the kanban board and drink coffee.

 

_{100% free, open source. No API keys. No configuration.}

Installation

No prerequisites — Claude Code can be installed and configured directly from the app.

May trigger SmartScreen — click "More info" → "Run anyway"

---

Development

Build from source

Prerequisites: Node.js 20+, pnpm 10+

git clone https://github.com/777genius/claude_agent_teams_ui.git
cd claude_agent_teams_ui
pnpm install
pnpm dev

The app auto-discovers your Claude Code projects from ~/.claude/.

Build for Distribution

pnpm dist:mac:arm64  # macOS Apple Silicon (.dmg)
pnpm dist:mac:x64    # macOS Intel (.dmg)
pnpm dist:win        # Windows (.exe)
pnpm dist:linux      # Linux (AppImage/.deb/.rpm/.pacman)
pnpm dist            # macOS + Windows + Linux

Scripts

Command	Description
pnpm dev	Development with hot reload
pnpm build	Production build
pnpm typecheck	TypeScript type checking
pnpm lint:fix	Lint and auto-fix
pnpm test	Run all tests
pnpm test:watch	Watch mode
pnpm test:coverage	Coverage report
pnpm check	Full quality gate (types + lint + test + build)

---

TODO

• Run not only on a local PC but in any headless/console environment (web UI), e.g. VPS, remote server, etc.
• 2 modes: current (agent teams), and a new mode: regular subagents (no communication between them)

---

Contributing

See CONTRIBUTING.md for development guidelines. Please read our Code of Conduct.

Security

IPC handlers validate all inputs with strict path containment checks. File reads are constrained to the project root and ~/.claude. Sensitive credential paths are blocked. See SECURITY.md for details.

License

MIT