The fastest CI/CD system for agentic engineering.
Coding agents run verploy verify, which rebases worktrees and runs automated verifications.
Users run verploy deploy, which builds on verploy verify, adding manual verification, fast-forward merging, and automated deployment.
- Uses a local-first workflow to significantly reduce per-prompt latency compared to using remote agents and GitHub's CI/CD
- Manual verification is programmatically defined on a per-project basis
- Worktree support enables agents to work independently
- Rebase conflict handling discourages agents from modifying git
- Works with Docker to sandbox agent execution and isolate deployment credentials
Verploy is available as verploy on PyPI.
Because Verploy uses other tools you have installed, it's recommended to install it per-project instead of globally:
uv add --dev verployAdd a .verploy/ directory to your project with any of these executable scripts:
verify-- runs verification checks (e.g. linting, type checking, tests)manual-- runs manual checks (e.g. human review, expensive tests)deploy-- runs after pushing (e.g. publishing to PyPI)
.verploy/verify:
#!/bin/bash
set -euo pipefail
uv run ruff check --fix .
uv run pytest.verploy/deploy:
#!/bin/bash
set -euo pipefail
uv build --no-sources
uv publish.verploy/manual:
#!/bin/sh
read -p "Review the code. Is it acceptable? (y/n) " answer
[ "$answer" = "y" ]uv run verploy verify
uv run verploy deploy❯ Run `uv run verploy verify` to check your changes
● Bash(uv run verploy verify)
⎿ Error: Exit code 1
Committing worktree changes...
Rebasing onto main...
╭───────────────────── Traceback (most recent call last) ──────────────────────╮
│ /home/peter/src/verploy/.claude/worktrees/readme/src/verploy/verploy.py:75 │
│ in verify_cmd │
│ │
│ 72 @app.command("verify") │
│ 73 def verify_cmd(ctx: typer.Context) -> None: # pragma: no cover │
│ 74 │ worktree, repo_dir = ctx.obj │
… +72 lines (ctrl+o to see all)
● Rebase conflict. Let me find and resolve the conflict markers.
Searched for 2 patterns (ctrl+o to expand)
● Main is at version 0.0.8 with the old description. I'll take the latest version from main
and keep our updated description.
Read 1 file (ctrl+o to expand)
● Update(pyproject.toml)
⎿ Removed 5 lines
1 [project]
2 name = "verploy"
3 -<<<<<<< HEAD
3 version = "0.0.8"
5 -description = "A local-first CI/CD tool for agentic engineering."
6 -=======
7 -version = "0.0.6"
4 description = "The fastest CI/CD system for agentic engineering."
9 ->>>>>>> 770fd1f (Commit)
5 readme = "README.md"
6 authors = [{ name = "Peter Lavigne" }]
7 requires-python = ">=3.12"
● Conflict resolved — kept version 0.0.8 from main with our new description. Let me re-run
verify.
● Bash(uv run verploy verify)
⎿ Building verploy @ file:///home/peter/src/verploy/.claude/worktrees/readme
warning: `build_system.requires = ["uv-build>=0.10.4,<0.11.0"]` does not contain
the current uv version 0.11.7
… +20 lines (ctrl+o to expand)
● All checks passed — linting, type checking, and tests (100% coverage). Changes are
verified and ready to deploy.
Licensed under the Apache License 2.0. See LICENSE.