velocity
Velocity is a local-first web app (Next.js + Bun) that acts as a command center for AI coding CLIs (Claude Code, Codex CLI, Gemini CLI). It runs and inspects coding sessions, captures analytics (usage/cost/latency/tools/routing context), and helps turn repeated patterns into reusable agents/workflows/skills/commands, including routing visualization. It also supports MCP (via the @modelcontextprotocol/sdk dependency) as part of its build layer surfaces.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
Security section is high-level: “local-first” and optional remote calls limited to explicit user-driven actions. The README does not describe web authentication/authorization, TLS requirements for the local server, secret storage/handling, or threat model details. Dependency hygiene is uncertain from the provided data (not assessed for CVEs here). Local SQLite storage suggests data-at-rest on device, but the documentation provided is insufficient to confirm encryption at rest or secure logging.
⚡ Reliability
Best When
You want local, inspectable AI-agent session history and a workflow builder/routing analytics layer around existing model CLIs on your own machine.
Avoid When
You require a fully specified public API contract (REST/GraphQL/OpenAPI) for programmatic integration, or you need explicit enterprise-grade auth/compliance details from documentation.
Use Cases
- • Run CLI-based AI coding sessions in a local workspace
- • Review session transcripts with usage/latency/cost/tool/routing context
- • Convert repeated agentic patterns into reusable workflows/skills/commands
- • Visualize routing graphs to debug and improve automation
- • Build and manage “agents” and “workflows” across Claude/Codex/Gemini with provider parity
Not For
- • As a hosted SaaS for team-wide collaboration without local deployment needs
- • As a standalone third-party REST API service consumed by external systems (it’s primarily an app/UI)
- • Environments requiring strong documented security guarantees beyond local-first defaults (README provides limited specifics)
Interface
Authentication
README describes local-first data handling but does not document any authentication mechanism for the web UI/API endpoints. Provider credentials for Claude/Codex/Gemini are not specified in the provided README content.
Pricing
Self-hosted open-source (AGPL-3.0) based on README; no hosted pricing model described.
Agent Metadata
Known Gotchas
- ⚠ This appears to be a local web app rather than a clear programmatic API; an agent may need browser/UI automation or direct internal module usage unless an external API is documented elsewhere.
- ⚠ PTY/node-pty setup issues on macOS can block session execution (README provides a chmod workaround), which may impact agent workflows if not handled.
- ⚠ The README lists MCP as a surface area but provides no concrete MCP server URL or tool schema in the provided content, so automated tool invocation may be unclear without further docs.
Alternatives
Full Evaluation Report
Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for velocity.
AI-powered analysis · PDF + markdown · Delivered within 30 minutes
Package Brief
Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.
Delivered within 10 minutes
Score Monitoring
Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.
Continuous monitoring
Scores are editorial opinions as of 2026-03-30.