Skip to content

Convoy

Convoy is an AI deployment agent that takes a codebase from commit to production with a human-in-the-loop approval model.

Core trick

Rehearses the build on an ephemeral twin, then promotes through canary gates and rolls back automatically when health signals fail.

Tags

Description

Convoy is an AI deployment agent that takes a codebase from commit to production with a human-in-the-loop approval model. It scans a repo, identifies the right deployment target, rehearses the build locally, surfaces failures with precise diagnostics, opens and merges PRs for fixes, manages deploy gates, stages required secrets, runs canary releases, and promotes to production only after explicit approval. The problem Convoy solves is the gap between “the code is ready” and “the product is safely live.” For most teams, shipping still involves manual coordination, repeated context switching, hidden environment issues, failed deploy retries, and fragile handoffs between coding, DevOps, and release approval. Convoy turns that messy, error-prone workflow into a guided, auditable pipeline where repetitive execution is automated and judgment stays with the engineer. In our demo, Convoy deployed a real Next.js pharmacy management app to Vercel, recovered from two real failures, resumed from the exact failed stage instead of restarting, validated the fix with live checks, and completed the release with production observation and health verification.
teckedd-code2save/convoy★ 10 forksTypeScriptMITCreated Apr 21, 2026 · last push Sep 28, 2026

README excerpt

# Convoy

**The deployment agent that ships your code — not a rewrite of it.**

Convoy turns "deploy this repo" into a safe, evidence-gated production deployment. It scans your repo, asks five questions once, rehearses the build on an ephemeral twin, authors only the deployment files you need, promotes through canary gates while real signals stay healthy, and auto-rolls back the moment they don't.

Every capability is exposed as an MCP tool so Claude Code — or any MCP client — can plan, apply, approve, and diagnose deployments as part of a larger workflow, while approval gates keep a human in the loop by default.

Built for the *Built with Opus 4.7* Claude Code hackathon (April 21–26, 2026).

---

## The Meridian scenario

Meet the problem Convoy was built to solve.

Meridian is a three-service fintech startup: an orders API (Express + Postgres), a PDF report renderer, and a payments worker. Their principal engineer Karan is leaving next week. Production is throwing intermittent 503s on the orders service — a mystery bug that only Karan fully understands. The CTO wants to ship a payment-processing refactor and bring up the new reports service before Karan walks out the door.

Without Convoy, the team is blocked. Every deployment went through Karan: he knew which environment variables were missing on Fly, which services depended on which, what the rollback story was. None of that is written down. The new engineer is afraid to touch prod.

With Convoy, they run one command:

``

Team