CI-native agent CLI tool for deterministic pipeline gating.
Overview
Clausura is a platform-agnostic agent CLI tool built for CI/CD pipelines. It runs bounded LLM agent tasks against your codebase, extracts structured findings, evaluates them against deterministic gating rules, and exits with a clear pass/fail signal. No mid-process questions, no human in the loop.
Key philosophy: closed-loop execution with deterministic gating. The LLM finds issues. The rule engine decides if they matter. Your pipeline gets a binary answer.
Clausura vs. generic agent harnesses
General-purpose agent harnesses (DeepSeek Harness, Claude Code, Codex and similar) optimize for open-ended interactive work: flexible plugin stacks, long-lived sessions, sub-agent orchestration, and human-in-the-loop approvals. They deliberately leave verdicts, structured output and resource bounds to the caller — their "success" means "the agent stopped", not "the task is done".
Clausura occupies the other side of the same problem and is deliberately not a general harness:
| Generic agent harness | Clausura | |
|---|---|---|
| Success semantics | last turn ended cleanly | gating rules evaluated over structured findings |
| Verdict | none (bare text output) | exit code 0/1/2/3 + SARIF v2.1.0 |
| Run bounds | unbounded (waits for quiescence) | max_iterations, timeout_secs, token_budget, max_total_tokens |
| Incomplete run | silent partial result | fail-closed by default (on_incomplete: fail) |
| Extensibility | plugin framework (everything swappable) | skills + MCP tools + preflight checks; static single binary |
| Deployment | runtime + plugins to install | one static binary, zero runtime dependencies |
| Audit trail | session event log (append-only) | append-only run event log + findings ledger + context archives |
If you are building an interactive coding agent, use a generic harness. If you need a deterministic gate in CI — an agent that must finish within bounds and produce a pass/fail answer a pipeline can trust — that is what Clausura is for.
Use cases
- Code review gating -- flag violations in pull requests before merge
- Cross-repo consistency checks -- enforce conventions across multiple repositories
- Smart gating -- fail the pipeline only when findings exceed configured thresholds
- i18n extraction and translation -- scan source files and validate locale coverage
- Architecture compliance -- verify code structure against project conventions
Installation
Shell script (Linux, macOS, WSL)
curl -fsSL https://raw.githubusercontent.com/liuyanghejerry/Clausura/main/install.sh | bash
The script detects your OS and architecture, downloads the latest release from GitHub, verifies the tarball against the release's checksums.txt (SHA256), and installs it to /usr/local/bin or ~/.local/bin.
Cargo
cargo install clausura-cli
Docker
docker pull ghcr.io/liuyanghejerry/clausura
docker run --rm -v $(pwd):/workspace ghcr.io/liuyanghejerry/clausura run
From source
git clone https://github.com/liuyanghejerry/Clausura.git
cd clausura
cargo build --release --package clausura-cli
# binary at target/release/clausura
Verify
clausura --version
# clausura 1.0.0 (commit: abc1234, built: 2026-05-23)
Supported LLM Providers
Clausura supports three vendor categories out of the box:
1. OpenAI-compatible
Any LLM that exposes an OpenAI-compatible /chat/completions endpoint:
No comments yet.