Velocity is a local-first command center for Claude Code, Codex CLI, and Gemini CLI. It helps you run sessions, understand what happened, and turn repeated work into reliable workflows.
Most CLI-only workflows break down as your team scales:
- session context is fragmented
- routing/entrypoint behavior is opaque
- reusable flows stay tribal knowledge
Velocity addresses this with three core loops:
- Run work in local CLI sessions.
- Inspect usage, cost, latency, tools, and routing context.
- Reuse what works as agents, workflows, skills, and commands.
These GIFs are embedded directly in the README and render on GitHub.
AI Assist setup -> finished workflow canvas -> AI prompt review -> node prompt editing.
Fullscreen routing deep-dive with readable node zoom and multi-node inspection.
Console -> Sessions -> Session Detail walkthrough with transcript filters and scrolling.
Two-session review workspace with compare scope and analysis controls.
All demos played continuously.
Continuous reel with short holds between each section.
Regenerate all demos:
python3 scripts/demo/capture-demos.py --base-url http://127.0.0.1:3000 --provider claude --target-seconds 12git clone https://github.com/OptimiLabs/velocity.git
cd velocity
bun install
bun devIf Console PTY launch fails on macOS during setup, run:
chmod +x node_modules/node-pty/prebuilds/*/spawn-helperOpen http://localhost:3000.
If you only learn one thing, learn this:
- Use Console and Sessions to capture real work.
- Convert proven patterns into Agents and Workflows.
- Use Routing and Analytics to validate that automation is actually correct and cost-efficient.
Velocity is organized into three layers:
| Layer | Purpose | Key surfaces |
|---|---|---|
| Workspace | Run and inspect | Console, Sessions, Review, Analytics, Usage |
| Build | Reuse and automate | Agents, Workflows, Skills, Commands, Hooks, MCP, Routing |
| Platform | Configure and extend | Models, Plugins, Marketplace, Settings |
Detailed inventory: docs/guides/functionality-inventory.md
| Capability | Claude | Codex | Gemini |
|---|---|---|---|
| Sessions + analytics ingestion | Yes | Yes | Yes |
| Agents (global + project scope) | Yes | Yes | Yes |
| Workflows | Yes | Yes | Yes |
| Skills + commands | Yes | Yes | Yes |
| Routing graph | Yes | Yes | Yes |
| Hooks | Yes | No | Yes |
| Plugins | Yes | No | No |
| Layer | Stack |
|---|---|
| Framework | Next.js 16 (App Router) |
| Runtime / PM | Bun |
| DB | SQLite (better-sqlite3) |
| State | TanStack Query + Zustand |
| Real-time | WebSocket + PTY manager |
| Graph UI | @xyflow/react |
| Tests | Vitest |
- Feature docs:
docs/features/ - Install + config guides:
docs/guides/ - Provider matrix:
docs/guides/provider-capability-matrix.md
Reinstall with Bun:
rm -rf node_modules
bun install- Verify
bun devstarts without PTY errors. - Hard refresh browser.
- Clear persisted local layout state.
If PTY launch fails because spawn-helper is not executable:
chmod +x node_modules/node-pty/prebuilds/darwin-arm64/spawn-helper
# or (portable across prebuild folders)
chmod +x node_modules/node-pty/prebuilds/*/spawn-helperThen restart bun dev.
Velocity is local-first. Data stays on your machine by default. Optional remote calls are limited to explicit user-driven actions (for example marketplace sources).
See SECURITY.md for reporting and policy details.
For questions or inquiries, contact: jaewonlee9642@gmail.com
See CONTRIBUTING.md for setup and PR workflow.