The web dashboard is the operator surface. The CLI is the execution surface. The Convex host is the shared state and dispatch layer between them.
agents is the canonical control plane for the local ~/.agents ecosystem. It combines a web dashboard, a local-first CLI, and a thin Convex host layer so work can be queued in the browser and executed on a real machine.
What ships
Inspect sessions, projects, skills, previews, annotations, search, and settings.
apps/app/src/app/**
Spawn sessions, poll for work, sync local state, manage previews, and report lifecycle events.
packages/cli/src/cli/commands/**
Mount @lnittman/convex-agents and expose dashboard-friendly queries and mutations.
packages/backend/convex/**
Document the product model, operator workflow, and source-of-truth paths for the repo.
apps/docs/**
Core flow
Web dashboard -> thread + queued session
agents work -> polls queued work from Convex
local agent -> runs the session on your machine
sync + traces -> feed the dashboard and thread transcript
operators -> inspect everything back in the dashboardQueue work in the web UI, keep agents work running locally, and use the dashboard to inspect transcripts, traces, and artifacts after execution.
Source of truth
- Product overview:
AGENTS.md - Repo overview:
README.md - Dashboard install route:
apps/app/src/app/install/page.tsx - Dispatch mutation:
packages/backend/convex/agentSystem/dispatch.ts - CLI entrypoints:
packages/cli/src/cli/commands/**