Zuvo

Auto-activating, multi-agent skill ecosystem for Claude Code, Codex, and Cursor.

51 skills, 26 specialized agents, quality gates, knowledge store, session recovery, and structured workflows — all in one plugin.

Install

Quick install (all platforms)

curl -fsSL https://raw.githubusercontent.com/greglas75/zuvo/main/scripts/quick-install.sh | bash

Installs to Claude Code + Codex + Cursor in one command. Restart your IDE after install.

Claude Code (recommended)

Requires Claude Code 1.0.33+. Check with claude --version, update with claude update.

# Add the Zuvo marketplace (one-time)
claude plugin marketplace add greglas75/zuvo-marketplace

# Install
claude plugin install zuvo

Codex

git clone https://github.com/greglas75/zuvo.git
cd zuvo
./scripts/install.sh codex

Cursor

git clone https://github.com/greglas75/zuvo.git
cd zuvo
./scripts/install.sh cursor

All platforms (for plugin developers)

./scripts/install.sh

Update

Claude Code

claude plugin marketplace update zuvo-marketplace
claude plugin update zuvo@zuvo-marketplace

Or enable auto-updates:

/plugin → Select zuvo-marketplace → Enable auto-update

If skills don't appear after update (known Claude Code cache issue):

claude plugin uninstall zuvo@zuvo-marketplace
claude plugin install zuvo

Then start a new session.

Codex / Cursor

cd /path/to/zuvo
git pull
./scripts/install.sh codex   # or: cursor, all

What install.sh does

One script, three platforms:

./scripts/install.sh          # all platforms (default)
./scripts/install.sh claude   # Claude Code only
./scripts/install.sh codex    # Codex only
./scripts/install.sh cursor   # Cursor only

Local development

For testing changes without committing:

# Edit files in zuvo-plugin/, then:
./scripts/install.sh

# Restart Claude Code / Codex to pick up changes

Optional: add CodeSift MCP for deep code analysis:

# ~/.codex/config.toml
[mcp_servers.codesift]
command = "npx"
args = ["-y", "codesift-mcp"]

What's inside

• Pipeline skills — zuvo:brainstorm → zuvo:plan → zuvo:execute with multi-agent exploration, quality gates, and evidence-based review
• 45 task skills — build, review, refactor, debug, 19 audits, write-article, content-expand, design, docs, ship, deploy, canary, retro, incident, mutation-test, benchmark, and more
• Release pipeline — zuvo:ship → zuvo:deploy → zuvo:canary for the full post-code lifecycle
• Knowledge Store — JSONL-based project memory. Skills learn from past sessions (patterns, gotchas, decisions). Auto-primed at session start and per-skill
• Session Recovery — execution state persisted to .zuvo/context/. Resume after context compaction or crashes without losing progress
• Adversarial review — 4-provider cross-model verification with evidence enforcement (findings without file:line auto-downgraded)
• Auto-activation — routing engine matches your intent to the right skill automatically
• CodeSift integration — semantic search, community detection, call chain tracing, complexity analysis
• Quality gates — CQ1-CQ29 (code quality) and Q1-Q19 (test quality) with unified severity vocabulary

Platform support

Skills

Documentation

• All 51 Skills
• Pipeline — brainstorm → plan → execute
• Quality Gates — CQ1-CQ29 + Q1-Q19
• CodeSift Integration
• Configuration
• Changelog

For maintainers

Release to marketplace (for end users)

./scripts/release.sh patch "fix: description"
./scripts/release.sh minor "feat: description"

This bumps version, commits, pushes, tags, updates marketplace SHA.

Install locally (for development)

./scripts/install.sh

This syncs source to Claude Code cache + Codex + Cursor. No git push, no marketplace update.

What package.json is for

Metadata only (name, version, description). There are no npm dependencies. No npm install needed. The version field is read by release.sh and install.sh.

License

MIT