Skip to content

Excellent 0.1.0 is on npm.Read the changelog

Give your agents a better chance

Excellent's v1 workflow re-runs frozen checks and returns failures with the evidence, giving your agent a concrete next step and you a record.

curl -fsSL https://excellent.so/install.sh | sh
How it works

Free to run. Yours to keep.

macOS today. Windows and Linux are not supported yet. Needs Node.js 22.3 or newer.

The CLI on npm today, 0.1.0 (checked October 27, 2026), predates the checked workflow shown here. Read the release status before installing.

~/ops · zsh
~/opsexcellent run --agent finance --task 2814
attempt 1 · correlationId 6f1c2a9e
task Pay invoice INV-20931, $4,820.00
agent done: payment ready to send
checks read the bank API and the ledger
✓ amount-matches-invoice PASS $4,820.00
✓ payee-on-approved-list PASS
✓ within-approval-limit PASS under $5,000
✓ no-duplicate-payment PASS
Verified · receipt kept on this machine
~/ops
Runs on your machineModel calls go to your provider
Receipt attempt 1Verified

Pay invoice INV-20931

financetask 28144 of 4 checks passed

Every check held. The receipt binds the task, the checks, the evidence and the verdict, and stays on this machine.

  • amount-matches-invoice$4,820.00
  • payee-on-approved-listPass
  • within-approval-limitPass
  • no-duplicate-paymentNone found

Why

AI agents can produce more work than people can carefully review. Asking another model whether the first one did a good job does not close that gap.

So Excellent treats every “done” as a claim and goes to look. The repo, the tests, the build and the browser can each tell us something real about the result. What holds up leaves a receipt. What does not goes back to the agent with the reason. Software comes first because it leaves unusually good evidence.

Your agent does the work, and Excellent starts the attempt, records what happened and checks the result against your repo and tools

Receipt · Attempt 2Verified

Refund order 58213

supporttask 3107correlationId 0b7d93c4

  • Agent version
  • Model
  • Instructions
  • Tools
  • Repo state
  • Task
Run

Every attempt starts on the record, with its agent, model, task and repo captured before the work begins.

Claim · checks read the order and the payment API

done: refund ready, $48.00

  • order-foundPass
  • refund-to-original-methodPass
  • amount-matches-items$48.00
  • within-refund-windowPass
Check

Done is a claim, so Excellent freezes the result and goes to look.

How checks decide

History

Attempt 1Returnedamount-matches-items: expected $48.00, observed $96.00
Attempt 2VerifiedLinks back to attempt 1. Both stay on the record.
Return

Wrong work comes back with the reason: the unmet check, what was expected and what was observed.

This receipt

Signed: Ed25519 over a canonical hashAppend-onlyKept in ~/.excellent

Receipt

Accepted work leaves a receipt, signed, append-only and kept on your machine.

Open a real receipt

Opened by

Claude Code, through MCP ~/.claude.json

Agents

Excellent lives inside the agent you already use, as one MCP entry in each agent's own config.

Every agent and its config file
Team · early access

Compare agent setups on held-out work

How promotion works

Open a receipt

Open a real receipt and read every field, with what it binds

This is the sample receipt from the Excellent docs: genuine output of the receipt pipeline, with a genuine signature, made from synthetic release evidence. Its verdict is FAIL. Point at any line to see what it binds.

sample-receipt.jsonReal, from the docs
  1. {
  2. "schemaVersion": 1,
  3. "serviceVersion": "2026-08-16.v1",
  4. "receipt": {
  5. "schemaVersion": 1,
  6. "id": "receipt_v0_release_4df3dd89b3e4d0a0",
  7. "tenantId": "tenant_v0_release",
  8. "runId": "run_v0_release_e44941560b9f",
  9. "parentReceiptId": null,
  10. "status": "FAIL",
  11. "checkResultIds": ["G00:PASS", "G01:FAILING", … 13 more],
  12. "evidenceHashes": ["sha256:437284d4…", … 4 more],
  13. "policyVersionRefs": ["policy_v0_release@2026.08"],
  14. "engineVersion": "v0-release@1",
  15. "issuedAt": "2026-09-16T12:37:22.257Z",
  16. "signature": { "algorithm": "ed25519", … 2 more }
  17. },
  18. "binding": {
  19. "predicate": "excellent.verification.agent-work-receipt.v1",
  20. "workItemId": "work_cand_9b618ed027764ef4bccf2a64_df-001",
  21. "workSnapshotId": "wsnap_work_cand_9b618ed027764ef4bccf2a64_df-001",
  22. "attemptId": "promo_23247c38c4574c96893c2036:release",
  23. "contractId": "verification-api/2026-08-16.v1",
  24. "evidenceSnapshotId": "evsnap_v0_release_4df3dd89b3e4d0a0",
  25. … 2 more fields
  26. "evaluatorRefs": ["evaluator:evidence-integrity", … 2 more],
  27. … 8 more fields
  28. "subject": { "treeHash": "git-tree:fcd3f669…", … 6 more },
  29. … 22 more fields
  30. },
  31. "payloadHash": "sha256:ea48ebc0c…",
  32. "signature": { "algorithm": "ed25519", "value": "ed25519:COSk…", … 1 more },
  33. "publicVerification": { "receiptId": "receipt_v0_rel…", … 8 more }
  34. }
Folded where a value runs long or the docs do not explain a field. Every field is in the viewer below.
Receipt…4df3dd89b3e4d0a0
Issued2026-09-16
SignedEd25519
VerdictFail
Looking atreceipt.status
On the receiptline 10

What it binds

One of the six verification states (PASS, MISMATCH, FAIL, UNKNOWN, NOT_RUN, PENDING). Here: FAIL.

Value

"FAIL"

What it binds is the docs’ own text, from “What each part is for”. A field the docs do not explain says so.

Point at a line, tap it, or tab to the receipt and use ↑ ↓.

Real receipt

Real receipt from the Excellent docs. Synthetic release evidence, genuine signature. Verdict: FAIL. A valid signature proves the receipt was not altered. It does not make the verdict good. Source

Open every field in the receipt viewerReal receipt · all fields
release-receipt.jsonReal, from the docs
  1. {
  2. "schemaVersion": 1,
  3. "serviceVersion": "2026-08-16.v1",
  4. "receipt": {
  5. "schemaVersion": 1,
  6. "id": "receipt_v0_release_4df3dd89b3e4d0a0",
  7. "tenantId": "tenant_v0_release",
  8. "runId": "run_v0_release_e44941560b9f",
  9. "parentReceiptId": null,
  10. "status": "FAIL",
  11. "checkResultIds": [
  12. "G00:PASS",
  13. "G01:FAILING",
  14. "G02:FAILING",
  15. "G03:PASS",
  16. "G04:PASS",
  17. "G05:PASS",
  18. "G06:PASS",
  19. "G07:PASS",
  20. "G08:PASS",
  21. "G09:RUNNING",
  22. "G10:PASS",
  23. "G11:PASS",
  24. "G12:BLOCKED_EXTERNAL",
  25. "G13:FAILING",
  26. "G14:PASS"
  27. ],
  28. "evidenceHashes": [ … ],5 items
  29. "policyVersionRefs": [ … ],1 item
  30. "engineVersion": "v0-release@1",
  31. "issuedAt": "2026-09-16T12:37:22.257Z",
  32. "signature": { … }3 fields
  33. },
  34. "binding": { … },40 fields
  35. "payloadHash": "sha256:ea48ebc0c36dced1cefd90ae750220594dd2e3124cc67c6ecb9ac524a2b55ca9",
  36. "signature": { … },3 fields
  37. "publicVerification": { … }9 fields
  38. }
Folded lines open with a click or EnterEvery field as published
Receipt…4df3dd89b3e4d0a0
Issued2026-09-16
SignedEd25519
VerdictFail

Fifteen checks: ten pass, three failing, one running, one blocked outside the run. One unresolved check sinks the set, so the receipt says FAIL.

Looking atreceipt.status
On the receiptline 10

What it binds

One of the six verification states (PASS, MISMATCH, FAIL, UNKNOWN, NOT_RUN, PENDING). Here: FAIL.

Value

"FAIL"

See also

What it binds is the docs’ own text, from “What each part is for”. A field the docs do not explain says so.

Point at a line, tap it, or tab to the receipt and use ↑ ↓. Enter opens a folded line.

Pricing

Free to run and yours to keep, with early access for teams and Excellent engineers to build it with you

Run Excellent locally for free. Teams can join early access, or work directly with Excellent engineers on a deployment.

Individual · Team · Deployment
  • Individual

    Start here

    Free for developers

    Run Excellent locally.

    Install Excellent

    No credit card, ever.

    Sign up free

    • The local app, CLI, verification loop and receipt viewer
    • Works with the agents you already use: Claude Code, Codex, Cursor and more
    • Independent evidence from tests, builds, browsers and Git
    • Local attempts, results and receipts, exportable any time
    • Bring your own model key. Agents bill to your account, never ours
  • Team

    Early access

    Contact us

    CI, baselines, experiments, policy.

    Join early access

    Self-hosted team sync is in beta today.

    • Everything in Individual
    • Verification in CI, beside the checks you already run
    • Baselines captured before the work, so before-and-after is provable
    • Experiments that compare agent setups on your own tasks
    • Team policy for what counts as done and what needs a person
  • Deployment

    Custom

    Work directly with Excellent engineers.

    Book a call

    Engagements start at $10,000/month. No minimum term.

    • Everything in Team
    • Hands-on installation and integration in your environment
    • Custom checks and evidence integrations built for your workflow
    • Release gates and policy review
    • Team training and an operating cadence
    • Direct access to the engineers doing the work

Every tier includes the same verification loop, local receipts, and agent integration. You bring your own model key.

Compare plans

Excellent Deployment

Put agents to work in your operation with Excellent engineers beside your team

We work directly with teams to find the workflows where agents can create meaningful leverage, build them into your existing systems, and establish the verification required to let them act.

DeploymentCustom

Engagement model

Six phases, each with a result you can check. They repeat as new workflows come into scope.

  1. 01FindIdentify workflows with high agent leverage and measurable outcomes
  2. 02DefineSpecify what success means and what evidence can prove it
  3. 03BuildConnect the agent to the actual tools and systems
  4. 04VerifyEstablish independent checks and escalation paths
  5. 05DeployShadow, then limited operation, then production
  6. 06ImproveUse production failures to improve the agent and verifier
Starts at
$10,000 a month
Term
No minimum term, no deposit, no termination fee
Book a call

Two commitments

We don’t deliver AI strategy decks; we ship working systems.

Every deployment is built to become less dependent on us over time.

FAQ

The questions people ask first, with the plain answers

Fig. · Portable typewriter, amber dither
01What is Excellent?

A verification system for agentic tasks. It runs beside the agent you already use, checks the work with independent evidence, and leaves a receipt you can inspect later.

02Is Excellent another agent?

No. Your agent does the work. Excellent starts the attempt, records what happened, checks the result against your repo and tools, and compares different ways of running it.

03Which agents does it work with?

The one you already use: Claude Code, Codex, Cursor, Copilot, Cline, Gemini, OpenCode, or any other agent that does work you can check. Excellent observes the run instead of replacing it.

04What does it actually check?

Whatever can prove the task: the git tree, tests, lint, the build, browser behavior, API responses, CI, and the deployment. When a check cannot run, Excellent says so instead of implying a pass.

05What happens when the agent is wrong?

The attempt is returned with the exact failure, expected behavior and observed behavior, and sent back to the agent. The original context and the retry history are kept on the receipt.

06Does my code leave my machine?

None of it reaches us. Excellent keeps your repository, attempts, evidence, and receipts in a local database on your machine, and sends none of it to Excellent. Model calls are the exception worth naming: they go from your machine to the provider you chose, on your own account, the same traffic your agent already makes. The security page has both paths in full.

07Is it really free?

Yes, for individuals. You install it and run it on your own machine, with no seats to buy and nothing metered for local verification. Team features are in early access; contact us to join.

08Has this made your agent better yet?

We are building Excellent with Excellent, and the results page shows where that stands.

Install

Try it on a real repo: install it, run one task and read the result

curl -fsSL https://excellent.so/install.sh | sh

Free to run. Yours to keep. macOS, Node.js 22.3 or newer.

Read the quickstart
ChangelogStable
0.1.0

Latest on npm

July 21, 2026@excellent-so/cli

The CLI moves from the beta channel to latest on npm. This is the build the installer gives you today.

Read the changelog