VespeR — Development agent for Claude Code

VespeR

Visual control plane for Claude Code workflows.

[Website](https://vesper.run) • [Repository](https://github.com/ranausmanai/VespeR)

VespeR helps you run coding workflows with more control than a single chat stream:

• reusable specialist agents
• reusable multi-agent patterns
• execution observability (DAG + timeline + activity)
• resumable interactive sessions with smart memory context

CLI commands:

• vesper (preferred)
• agentling (backward-compatible alias)

Product Tour



What VespeR Does

1. Interactive sessions you can rejoin

• Start multiple interactive sessions and switch between them.
• Stop current response without ending the session.

1. Agent Dock in chat

• Ask a specialist agent (reviewer, security, strategist, etc.).
• Inject agent output back into the active interactive session.

1. Pattern execution

• Run saved patterns such as:
  • Quick Build (Solo)
  • Build + Review Loop
  • Release Readiness Panel
  • Expert Panel
  • Debate

1. Execution visibility

• See what happened via DAG, timeline, and split activity views.
• Inspect tool usage and file-touch activity during agent/pattern runs.

1. Smart resume memory

• Ended runs are converted into structured memory.
• New interactive runs can start with ranked context packs (goal, touched files, open loops, validations, next action).

Key Use Cases

1. Build and review in one pass

• Run Build + Review Loop so code generation and code review are linked.

1. Release go/no-go checks

• Run Release Readiness Panel for security/performance/product sign-off.

1. Long-running continuity

• End and later resume with context pack instead of replaying long transcripts.

1. Debugging agent behavior

• Use DAG/timeline/activity to diagnose loops, failures, and churn.

Requirements

• Python 3.10+
• Node.js 18+
• Claude Code CLI available on PATH

Install

# Clone
git clone https://github.com/ranausmanai/VespeR.git
cd VespeR

# Backend
pip install -e .

# Frontend
npm -C frontend install
npm -C frontend run build

# Native macOS shell (optional)
pip install -e ".[desktop]"

# macOS app bundle + DMG build toolchain (optional)
pip install -e ".[desktop-build]"

Run

# Start native macOS app
vesper desktop

# Start UI + API server in browser
vesper ui --port 8420 --no-browser

Open the browser UI at: `http://127.0.0.1:8420`

If `vesper` is not found, use:

agentling desktop

# Start UI + API server
agentling ui --port 8420 --no-browser

For frontend development inside the native shell:

vesper desktop --dev --frontend-url http://127.0.0.1:5173

Run `npm -C frontend run dev` in a second terminal first.

macOS App Distribution

Build a standalone `.app` and `.dmg` while keeping the browser UI flow intact:

pip install -e ".[desktop-build]"
bash scripts/build_macos_app.sh

Artifacts: