1. Conduid
  2. AI
  3. Velocity
MCP server · AI

Velocity

by · github.com/OptimiLabs/velocity

Local-first workspace for Claude Code, Codex CLI, and Gemini CLI with sessions, analytics, workflows, and tools

Unclaimed AGPL-3.0 last commit 7 months ago 3d-globeadsbaircraft-trackingaiscesiumfastapiflight-trackinggeointgeospatialintelligence-analysiskeylessopen-source-intelligenceosintpythonreactsatellite-trackingself-hostedsituational-awarenesstypescriptvessel-tracking
InstallView source
67Good

Scored 2 months ago · breakdown

About Velocity

Velocity is an MCP server published by OptimiLabs in the AI category: local-first workspace for Claude Code, Codex CLI, and Gemini CLI with sessions, analytics, workflows, and tools.

The repository has 44 stars and 3 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/OptimiLabs/velocity

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Velocity

Powered by Claude · Grounded in docs

I know everything about Velocity. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 2 hours ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • ✓Tests presentA test suite exists in the repository.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • !No dynamic code executionSource scan found eval or shell execution. Review how tool inputs reach it before granting credentials.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

Releases

v0.1.1v0.1.1 · 27 Feb 2026Full Changelog**: https://github.com/OptimiLabs/velocity/commits/v0.1.1

README

Velocity

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.

Built with Bun Next.js 16

Why Velocity

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:

  1. Run work in local CLI sessions.
  2. Inspect usage, cost, latency, tools, and routing context.
  3. Reuse what works as agents, workflows, skills, and commands.

Preview

These GIFs are embedded directly in the README and render on GitHub.

Workflow Builder

AI Assist setup -> finished workflow canvas -> AI prompt review -> node prompt editing. Workflow Builder Demo

Routing Graph

Fullscreen routing deep-dive with readable node zoom and multi-node inspection. Routing Demo

Sessions Journey

Console -> Sessions -> Session Detail walkthrough with transcript filters and scrolling. Sessions Journey Demo

Review Compare

Two-session review workspace with compare scope and analysis controls. Review Compare Demo

Back-to-Back Reel

All demos played continuously. Back-to-Back Demo Reel

Stitched Reel

Continuous reel with short holds between each section. Stitched Demo Reel

Regenerate all demos:

python3 scripts/demo/capture-demos.py --base-url http://127.0.0.1:3000 --provider claude --target-seconds 12

Start in 60 Seconds

git clone https://github.com/OptimiLabs/velocity.git
cd velocity
bun install
bun dev

If Console PTY launch fails on macOS during setup, run:

chmod +x node_modules/node-pty/prebuilds/*/spawn-helper

Open http://localhost:3000.

Workflow-First Mental Model

If you only learn one thing, learn this:

  1. Use Console and Sessions to capture real work.
  2. Convert proven patterns into Agents and Workflows.
  3. Use Routing and Analytics to validate that automation is actually correct and cost-efficient.

Feature Inventory

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

Provider Parity

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

Core Tech

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

Docs

Troubleshooting

better-sqlite3 binding errors

Reinstall with Bun:

rm -rf node_modules
bun install

Console terminal blank / stuck

  1. Verify bun dev starts without PTY errors.
  2. Hard refresh browser.
  3. Clear persisted local layout state.

node-pty spawn-helper permission denied (macOS)

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-helper

Then restart bun dev.

Security

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.

Inquiries

For questions or inquiries, contact: jaewonlee9642@gmail.com

Contributing

See CONTRIBUTING.md for setup and PR workflow.

README fetched from the repository 2 hours ago. The original is authoritative.

Questions

About Velocity

How do I install Velocity?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Velocity safe to use with an AI agent?

Its trust score is 67 out of 100 (good). It passes 4 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Velocity still maintained?

The last commit was 7 months ago and 5 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.