Self-hosted, mobile-first AI agent orchestration platform.
Queue tasks, monitor agent thought streams, respond to blockers, and approve diffs — all from your phone.
- Bun 1.1+
- Node.js 20+ (for some native modules)
- Git
# Clone
git clone https://github.com/your-org/agemon.git
cd agemon
# Configure environment
cp .env.example .env
# Edit .env — set AGEMON_KEY and GITHUB_PAT
# Install dependencies
bun install
# Start backend + frontend in parallel
bun run dev- Frontend: http://localhost:5173
- Backend API: http://localhost:3000
- Health check: http://localhost:3000/api/health
cd backend
bun run src/db/seed.ts| Layer | Choice |
|---|---|
| Runtime | Bun 1.1+ |
| Backend | Hono 4.x |
| Database | SQLite (bun:sqlite) |
| Frontend | React 18 + Vite 5 |
| UI Components | shadcn/ui + Tailwind CSS |
| Router | TanStack Router |
| State | TanStack Query + Zustand |
| Terminal | xterm.js (lazy-loaded) |
| Git | simple-git |
| Agent Protocol | ACP SDK |
agemon/
├── backend/ # Hono server + DB + agent management
├── frontend/ # React + Vite mobile-first UI
├── shared/types/ # Shared TypeScript types
├── website/ # Astro landing page + docs
├── .env.example
└── package.json # Bun workspace root
See docs/deployment/ for:
All API endpoints require a Bearer token:
Authorization: Bearer <AGEMON_KEY>
Set AGEMON_KEY in your .env file.
MIT