Harness integrationavailable
Wrap verification results into an agent harness's hook contract via --harness.
built by aktagon.com
Gate every commit and every agent turn on your project's own build and tests — across every stack in the tree.
wrkgrd is a CLI that detects the stacks in your repo and runs the right build, test, and lint tools for each — cargo, go test, eslint, pytest. One verdict for a human at a commit and an agent at end-of-turn.
Same tree, same verdict, same exit code.
$ wrkgrd init Created wrkgrd.toml $ wrkgrd hooks install Installed pre-commit hook — commits now run 'wrkgrd verify'. $ wrkgrd rust · cargo test error[cargo-test]: 1 test failed parser::tests::rejects_empty ... FAILED × 1 tool failed · exit 1
Gate your build. · Run the tools you already have.
01 For the agent wrangler
wrkgrd runs the real build and tests before the commit — and fails the gate like a red CI.
# agent: "done — added the parser." $ wrkgrd verify rust · cargo build error[cargo-check]: cannot find type `Token` in this scope --> src/parser.rs:42:18 × build failed · exit 1 — the commit is blocked
02 One contract, two readers
Every command emits --format json, keeps stdout a clean parseable stream, and returns documented exit codes. --harness wraps the verdict into an agent's hook contract — so an agent can't declare done while the build is red.
$ wrkgrd verify --format json | jq '.diagnostics[0]' { "tool": "cargo-test", "stack": "rust", "severity": "error", "message": "parser::tests::rejects_empty failed" } $ echo $? 1 # branch on it, no text parsing
03 Every capability
Run every detected stack's build and tests. Human output, or --format json for agents.
Write a starter wrkgrd.toml for the repo in one command.
List the verification-tool catalog — every tool, its stack, and the command it runs.
Browse the capability catalog, including agent-harness integration.
Wire wrkgrd into pre-commit, CI, or a Claude stop-hook.
Print the end-user guide bundled with the binary.
Wrap verification results into an agent harness's hook contract via --harness.
Ontology-driven catalog of build/test/lint tools, per stack, listed by `wrkgrd rules`.
Warn-only checks on weak config and missing hygiene files: lint/compiler strictness, formatter-hook presence, .gitignore/.dockerignore presence (never block).
Audit a project's MCP server tool definitions for context bloat.
Block a commit that stages a hardcoded secret — native scanner plus opt-in gitleaks, at the pre-commit hook.
04 See it work
# agent ends its turn ✓ "Implemented the parser. Tests pass." ↳ cargo test was never run. The commit lands red. CI fails ten minutes later.
$ git commit -m "add parser" running wrkgrd verify… error[cargo-test] rust · 1 test failed parser::tests::rejects_empty ✗ commit blocked · exit 1 # fix it before it enters history
05 What it runs
wrkgrd detects the stacks in your tree and runs the right build, test, and lint tools for each. Point it at a repo and every stack is verified with the tools it already uses.
Build, test, lint, and dead-code/unused-dep checks for Cargo projects.
Build, vet, test, and error-handling checks for Go modules.
Build, type-check, lint, test, and dead-code checks for Node projects.
Test, lint, and dead-code checks for Python projects.
Test and error-handling checks for Ruby projects.
Repo-hygiene gates: commit messages, branch scope, secrets, release guard.
Container-hygiene checks for Docker projects.
wrkgrd is free and MIT-licensed, forever. Part of the *grd family — ctxgrd lints your docs, wrkgrd verifies your code.