A local-first application that orchestrates AI coding agents through a workflow-driven pipeline. Runs as a system service on your machine with a web-based UI for managing work items, monitoring agent activity, and reviewing results. A Router agent automatically transitions work items between workflow states, creating a fully autonomous development pipeline that you can toggle on or off.
- Workflow Engine — 8-state machine (Backlog → Planning → Decomposition → Ready → In Progress → In Review → Done / Blocked) with automatic transitions
- Agent Personas — Configurable AI personas (Product Manager, Tech Lead, Engineer, Code Reviewer, Router) assigned per workflow state
- Work Item Hierarchy — Recursive parent-child work items with dependency graph and automatic parent coordination
- Real-time Monitoring — Live agent terminal output, execution timeline, cost tracking, and activity feed via WebSocket
- MCP Tool System — 7 built-in tools agents use to interact with the system (post comments, create children, route state, etc.)
- Cost Management — Monthly/daily spend caps, warning thresholds, per-execution cost tracking
- Project Memory — Agents build cumulative project context from completed work
- Local-first — SQLite storage, runs on your machine, no cloud dependency
packages/
frontend/ React 19 + Vite + Tailwind + shadcn/ui + TanStack Query + Zustand
backend/ Fastify + better-sqlite3 + Drizzle ORM + WebSocket + Claude Agent SDK
shared/ TypeScript types and constants shared between packages
# Clone the repository
git clone https://github.com/ashams1026/agentic-coding.git
cd agentic-coding
# Install dependencies
pnpm install
# Start development servers (frontend + backend)
pnpm devThe frontend runs at http://localhost:5173 and the backend API at http://localhost:3001.
# Build all packages
pnpm build
# Start as a background service
pnpm service:start
# Check status
pnpm service:status
# View logs
pnpm service:logsConfiguration lives at ~/.agentops/config.json. Set your Anthropic API key in the Settings UI or via CLI:
npx agentops config set anthropicApiKey sk-ant-...See docs/deployment.md for all configuration options.
| Document | Description |
|---|---|
| Getting Started | Step-by-step setup and first workflow |
| Architecture | System design, packages, data flow |
| Data Model | Entities, relationships, schemas |
| Workflow | State machine, transitions, routing |
| Personas | Agent roles, prompts, configuration |
| API Reference | REST endpoints, WebSocket protocol |
| MCP Tools | Agent tool descriptions and schemas |
| Deployment | Configuration, service management, CLI |
| Frontend | UI architecture, components, patterns |
pnpm dev # Start all packages in dev mode
pnpm build # Build all packages
pnpm test # Run tests
pnpm lint # Lint source files
pnpm typecheck # Type-check all packagesPrivate — not open source.