verploy 0.0.21

The fastest CI/CD system for agentic engineering.

Verploy

The fastest CI/CD system for agentic engineering.

Users run verploy, which runs manual verification, fast-forward merges worktrees, pushes, and deploys.

Features

• 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
• Works with Docker to sandbox agent execution and isolate deployment credentials

Installation

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 verploy

Setup

Stop hook

Verploy expects changes to be committed and worktrees to be rebased onto main before it runs. Add verploy-hook as a Claude Code Stop hook to enforce this automatically.

.claude/settings.json:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "uv run verploy-hook",
            "timeout": 600
          }
        ]
      }
    ]
  }
}

The hook checks that there are no uncommitted changes, the branch is rebased onto main (in worktrees), and runs the verify script if one exists.

Scripts

Add a .verploy/ directory to your project with any of these executable scripts:

• verify (optional) -- runs automated quality checks on Stop (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)

Example .verploy/ scripts

.verploy/verify:

#!/bin/bash
set -euo pipefail

uv run ruff format .
uv run ruff check --fix .
uv run pyright
uv run pytest --cov --cov-fail-under=100

.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" ]

Usage

uv run verploy

License

Licensed under the Apache License 2.0. See LICENSE.