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. Just download, open, and see everything Claude Code did.}

Installation

Direct Download

Platform	Download	Notes
macOS (Apple Silicon)	.dmg	Download the arm64 asset. Drag to Applications. On first launch: right-click → Open
macOS (Intel)	.dmg	Download the x64 asset. Drag to Applications. On first launch: right-click → Open
Linux	.AppImage / .deb / .rpm / .pacman	Choose the package format for your distro (portable AppImage or native package manager format).
Windows	.exe	Standard installer. May trigger SmartScreen — click "More info" → "Run anyway"

The app reads session logs from ~/.claude/ — the data is already on your machine. No setup, no API keys, no login.

---

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.

---

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