{"id":"optimilabs-velocity","name":"velocity","homepage":null,"repo_url":"https://github.com/OptimiLabs/velocity","category":"devtools","subcategories":[],"tags":["ai-ml","local-first","developer-tools","workflow-automation","session-analytics","model-context-protocol","nextjs","bun","sqlite"],"what_it_does":"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.","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)"],"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.","alternatives":["OpenWebUI/LibreChat-style local UIs for LLMs (different focus)","Model Context Protocol tools/clients that provide agent workflows without a dedicated local session analytics/workflow canvas","Custom dashboards built around your CLI’s logs + SQLite + a Next.js admin UI","Other local-first developer tooling/workflow orchestrators (varies by ecosystem)"],"af_score":40.0,"security_score":35.2,"reliability_score":25.0,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T15:25:14.336104+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":false,"mcp_server_url":null,"has_sdk":true,"sdk_languages":["TypeScript","JavaScript"],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Local usage (no auth described for accessing the app)"],"oauth":false,"scopes":false,"notes":"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":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Self-hosted open-source (AGPL-3.0) based on README; no hosted pricing model described."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":["Local machine (by default)"],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":40.0,"security_score":35.2,"reliability_score":25.0,"mcp_server_quality":35.0,"documentation_accuracy":45.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":90.0,"rate_limit_clarity":0.0,"tls_enforcement":50.0,"auth_strength":20.0,"scope_granularity":0.0,"dependency_hygiene":55.0,"secret_handling":60.0,"security_notes":"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.","uptime_documented":0.0,"version_stability":45.0,"breaking_changes_history":0.0,"error_recovery":55.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_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."]}}