Offline deterministic engineering-trust certificates for repositories, with no telemetry.
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent β or use 1-click editor setup below.
π‘ Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Cejel ("SEH-jel") β a trust certificate for your codebase.
Free, offline, no-signup CLI that scores the engineering signals that tell you whether to trust a repo β tests, secrets, isolation, claim-vs-reality, CI/audit discipline β and prints a trust certificate + badge. Especially valuable when AI wrote a lot of the code: that's exactly when you can't eyeball trust. Built on a deterministic, no-LLM scoring core β the free path makes zero network calls and requires no account.
Claim boundary: Cejel scores engineering-trust signals; it does not claim to detect software defects or prove that code is safe. Defect and vulnerability scanners remain evidence producers that Cejel can aggregate into a trust certificate.
Cejel is not another point scanner competing with the one you already run β it's the open, portable, offline trust certificate that aggregates them. Pipe in SARIF-compatible output (MunaTrust, Snyk, Semgrep, CodeQL, Codex) plus OpenSSF Scorecard, and get one shareable certificate + badge over all of them. See "Aggregate your scanners" below.
Dogfooded in production. Cejel is run continuously on Barg Labs' own multi-product monorepo β the ten-product studio it was built inside β which it currently scores 3.3/4.0 on its rubric-native certificate. That transparency snapshot opts into prospective v18; the public CLI default remains calibrated v17. On the comparative board, our code sits outside the ranked population and receives no verdict band. We score ourselves before asking you to score yourself.
The public CLI default is witan-rubric-v17-2026-07-24, the last rubric to clear Cejel's
preregistered 200-repository untouched holdout. Published calibration figures apply only to that
exact rubric and frozen evaluation population. Later rubricsβincluding the current v18 through
v22 prospective seriesβare available only to explicit evaluation harnesses. Prospective rubrics
inherit none of v17's calibration figures; a bounded paired repair or corpus-delta result can
validate its stated construction without transferring precision, recall, or false-positive-rate
claims. Promoting a prospective rubric to the public default requires a fresh authenticated
untouched holdout, every preregistered gate to pass, and a separately recorded promotion decision.
No account, no key, no signup.
Single-file binary. One file. No Node, no npm, no node_modules, nothing installed.
Windows x86_64 (PowerShell).
Windows signing status:
cejel-Windows-x86_64.exeis intentionally unsigned in 0.4.0 and may trigger Microsoft SmartScreen. The release build removes Node's inherited signature before SEA injection and fails unless Windows reports the result asNotSigned; it does not ship an invalid signature. Before running it, verifySHA256SUMSand the GitHub build-provenance attestation. Each binary also has an attached SPDX SBOM and an own-platform verification receipt covering--version,--help, a real scan, source/binary parity, and a network-denied scan. If your policy requires Authenticode, use the npm package or the OCI image until a human-approved signing path is available.
Don't take the offline claim on trust β check it. Turn your network off, then run the binary. It will score your repository and write you a certificate anyway. That is the whole product, and you can falsify it in ten seconds:
npm.
Distribution note: Cejel
0.4.0is the coordinated release version for npm, standalone binaries, Docker/OCI, GitHub Action, Homebrew, and MCP Registry.
npx can reuse a stale cached package. Force the current npm release with the @latest
specifier above, and check the version that will run before comparing certificates:
If a root package.json still carries a template name, override only the certificate display
name while keeping the repository-derived stable slug:
The npm package is scoped as @cejel/cejel; its executable remains the short command cejel.
GitHub Action β score every PR and publish the badge:
From source β it is AGPL and it runs offline, so reading it is rather the point:
Released binaries: cejel-Darwin-arm64, cejel-Darwin-x86_64, cejel-Linux-aarch64,
cejel-Linux-x86_64, and cejel-Windows-x86_64.exe. The release also carries
SHA256SUMS, a per-binary SPDX SBOM, and an own-platform verification receipt. Each binary
is executed against the source build and with networking denied before attachment. Releases
from v0.1.6 also carry a Sigstore bundle containing GitHub's signed build-provenance
attestation for the release set. Verify a downloaded binary with:
This is cryptographically signed provenance. It is distinct from Apple Developer ID or Microsoft Authenticode code-signing.
Docker / OCI. The current container release is 0.4.0:
The image defaults to cejel-mcp over stdio. To use the CLI instead:
The OCI image carries an SBOM, maximum-mode build provenance, and a signed registry attestation.
This repo ships the Cejel OSS trust leaderboard: elite OSS
projects, the public Cejel repository itself, and one explicitly labeled transparency
snapshot from the private studio monorepo where Cejel was built, with a per-repository
evidence report for every row under leaderboard/reports/. The
board is also hosted at cejel.dev. Every score is produced by the same
sealed public scorer used by npx @cejel/cejel .; no private domain collector contributes.
For each public-repository row, check out the immutable source commit printed in its report
and run the public scorer to reproduce the score, verdict, measured coverage, and evidence.
The private Alfred snapshot discloses its limitation instead: its source commit and withheld
locations are not publicly available, so that row is not independently reproducible and is
not presented as a public-repository self-score.
A path is published exactly when the reader can check it. Every public repository on the board cites full evidence paths and line numbers, everywhere, in every artifact β a certificate whose evidence you cannot open is not evidence. The private-repository entry (the studio monorepo's transparency snapshot) never cites a source path, anywhere, in any field or format β but the finding itself, its dimension, status, score, and content hash always survive; only the location is withheld, marked uniformly as "path withheld β private repository". Redaction removes a location, never a fact: a private repository failing its own check still shows up on its certificate, by name. The v3 repository scanner marks B1 and B5 not applicable for every repository, including ours; it does not accept structured substrate evidence for them. They remain defined for other rubric inputs, while the repository ranking excludes them fail-closed. Nobody is scored on evidence the public scanner cannot collect.
Calibrating a rubric against real, elite repositories surfaces mistakes; the record is part
of the trust claim, not something to bury. Two dimensions produced a punitive score for the
absence of a ratable surface rather than a real weakness, and both are fixed:
Django was flagged critical on dependency hygiene for using version ranges instead of exact
pins β normal, deliberate practice for a library, not an app; the rubric now scores
dependency hygiene against archetype-appropriate norms. OSSF Scorecard β Google's own
supply-chain security auditing tool β was flagged critical on audit-trail completeness for
publishing release notes via GitHub Releases instead of a committed CHANGELOG.md; a
repository with no ratable audit surface now returns "insufficient data" (excluded from the
composite) instead of a punitive score. The board also publishes a measured-coverage
indicator per row: a score reflects only its measured dimensions, and a row scored on fewer
than half of its applicable dimensions is shown as unranked rather than ordered against
better-evidenced rows.
scan scores the current directory with sensible defaults: no signup, fully offline. The
original ./cejel . form remains supported as a compatibility shorthand.
Prints a concise terminal certificate and writes to .cejel/:
report.json β the full structured report; scored runs carry numeric headline scores and a
score-band verdict, while abstained runs carry null scores and verdict: "insufficient_source"attestation.json β an unsigned in-toto statement binding the report digest, repository
revision, rubric, and scored-or-abstained outcome; ready for an external signercertificate.html β a self-contained HTML certificate (no external assets)badge.json β a shields.io endpoint payloadbadge.svg β a static, self-contained trust-score badgesummary.json β a compact digest (score, verdict, top findings)The attestation is deliberately explicit about its assurance level: Cejel creates the
statement, but it does not pretend to be an independent signer. Until a customer, reviewer,
or provenance system signs it, assurance.status is unsigned and issuer is
self-generated. An abstained scan carries only the refusal reason, never a numeric score.
Verify that an emitted report still matches its attestation:
This verifies the report schema and the report-to-attestation digest, repository, rubric, timestamp, and outcome binding. It does not verify a signature or signer identity; the command prints that boundary on every successful verification.
<path> β repo to score (default: current directory)--out <dir> β where to write report/certificate/badge files (default: .cejel;
--out-dir remains available as a compatibility alias)--min-score <n> β exit non-zero if the overall score is below n (0β4), or if Cejel
abstains and therefore cannot evaluate the threshold; used by the GitHub Action's optional
threshold gate--ingest <file|glob> β fold another scanner's output into the score (repeatable). Accepts
SARIF, OpenSSF Scorecard JSON, or the generic Cejel external-signal shape β format is
auto-detected. See "Aggregate your scanners" below.--quiet β suppress the terminal certificate (files are still written)-h, --help β print usage and exit successfully-v, --version β print the version derived from the package manifest and exit successfullyCejel reads a repository's file tree, not its bytecode β it needs to recognise a file's source extension to say anything about it. It does not support every language, and it says so honestly rather than guessing:
unrecognised_ecosystem archetype, an explicit
insufficient_data criterion status, null headline scores, and an explicit machine verdict
of insufficient_source β never a numeric score-band verdict, and never the word
"Unverified" for the sole reason that cejel cannot read the language. The certificate states
plainly which of the 11 dimensions were and were not measured.This list will grow. It will never be "any codebase" β that claim is a promise the parser cannot keep, and an honest support matrix is worth more than a marketing line the code contradicts on the first unsupported repository someone runs it against.
Cejel doesn't compete with your AI-code scanner (MunaTrust, Snyk, Semgrep, CodeQL, Codex,
whatever runs in CI) β it sits on top of it. Feed a scanner's output in with --ingest and
Cejel folds those findings into the same rubric-scored, offline trust certificate, with the
contributing tools shown in the certificate and report as provenance:
Or drop files in .cejel/inputs/ and they're picked up automatically, no flag needed:
External findings only ever adjust a dimension score downward, and by a bounded amount β
they augment the native repo scan, they never replace it. Every ingested file is attributed
by name in certificate.html, report.json (consumedSignals), and the terminal output
("Incorporates findings from: ..."), so the certificate reads as a visible aggregation, not a
black box.
Three ways a scanner's output gets ingested:
SARIF β any SARIF 2.1.0-emitting tool (Semgrep, CodeQL, most commercial SAST/AI-code
scanners) works with zero configuration; --ingest auto-detects the runs array.
OpenSSF Scorecard β scorecard --repo=... --format=json > scorecard.json, then
--ingest scorecard.json; auto-detected by its checks array.
Generic JSON β for a tool that emits neither, map its output into the minimal shape
below (or write a small adapter mirroring
scorecard-adapter.ts if the format needs real
parsing):
dimension is one of the Witan rubric criterion ids (A1-A5, B1-B6); weight
(0β1, default 0.5) bounds how much this signal can move that dimension; severity is
critical | warning | info; location is optional.
Endpoint JSON (host badge.json anywhere static β a repo file, a gist, GitHub Pages β and
point shields.io at it):
Or commit/link the static SVG directly:
See action/action.yml β runs Cejel on push/pull_request,
posts the score + top findings to the job summary, and can optionally fail the check below
a configurable min-score threshold. The scoring step makes no network calls and needs no
secrets.
The same package ships a second bin, cejel-mcp β a thin MCP (Model Context Protocol)
server over stdio, so any MCP client (Claude Code, Cowork, Cursor, Codex) can request a
trust certificate as a tool call. It wraps the exact same scan the CLI runs β same scores,
same verdict β and is listed on Smithery via the repo's smithery.yaml.
Add it to an MCP client config:
The server exposes one tool and two resources:
scan β input { path, format? }; scores the repository at path and returns the trust
cert as JSON (format: "summary", the default, is the compact digest; format: "json" is
the full report, identical to the CLI's report.json).cejel://last-scan/certificate.html and cejel://last-scan/badge.svg β the
HTML certificate and SVG badge for the most recent scan (the URI scheme derives from the
npm package name).Like the CLI, scoring over MCP is fully offline: no network calls, no telemetry, no signup, and the server writes no files.
OpenClaw stores outbound MCP servers under mcp.servers. Add Cejel with the npm package's
shipped cejel-mcp bin:
The equivalent OpenClaw command is:
The OCI image is an alternative when Docker is the preferred execution boundary. Replace the host path with the repository OpenClaw should allow Cejel to read:
Cejel is active in the Official MCP Registry as io.github.BargLabs/cejel. The explicit
OpenClaw configuration above works independently of catalog indexing.
Cejel scans code you point it at. This free adoption surface does not watch, intercept, or govern an agent's runtime actions. Runtime-action governance is a separate boundary for the future paid Agent Pack.
Scoring a repo β cejel scan . itself, and the Action's scoring step β makes zero network
calls: no telemetry, no signup, no model call. The scanner does invoke your local git
binary through one hardened subprocess chokepoint: fixed argv only (never a shell), an
explicit timeout and output bound, prompts and network transports disabled, proxy variables
removed, and repository-controlled filesystem monitoring neutralized. A static CI guard
allows node:child_process in that one module only and rejects direct network primitives
everywhere, while each release binary is also scanned with outbound networking denied.
Fetching the @cejel/cejel package the first time (like any npm-distributed CLI, including
this Action's own dependency install) does need network; that's a one-time install cost, not
part of the scoring guarantee. If the tracked-file inventory fails unexpectedly, the JSON,
HTML, and markdown certificates declare that the scanner used its bounded directory fallback
instead of silently presenting the two inventories as equivalent.
Cejel does not collect telemetry. External validation is therefore opt-in and inspectable:
Submit only public or redacted evidence. Never put credentials, proprietary strategy code, patient data, or protected health information in a GitHub issue.
We publish a trust board scoring a corpus of well-known open-source repositories alongside our own. Running a leaderboard on other people's code obliges us to be exact about how it works, so here is all of it.
What we redact, and on what basis. One rule: a path is published exactly when you can check it. For a public repository, every evidence path and line number is cited in full β a certificate whose evidence you cannot open is not evidence. For a private repository (ours), no source path is cited anywhere, in any field or format; an unverifiable path tells you nothing you can check while disclosing our file tree for free. Redaction removes a location, never a fact: the finding, its dimension, its status, its score, and its content hash all survive. Where a path is withheld you will see it said plainly. This is enforced structurally β the public artifacts are built from filtered data rather than rendered and then scrubbed β and a build that would emit a private path fails rather than publishes.
What we exclude from ranking. The v5 repository scanner does not evaluate B1 (dispatch trace completeness) or B5 (verified learning trace) for repository inputs, including ours: both are always not applicable in a repository certificate. They remain defined in the rubric for structured substrate evidence, but that evidence is not accepted by this scanner. The ranking excludes both dimensions fail-closed, including when it reads a legacy or separately produced structured report. We neither score you on evidence the public scanner cannot collect nor award ourselves points for evidence you cannot contest.
Where we were wrong. Calibrating this rubric against real repositories β and running the board itself like a stranger would β surfaced the errors below in our own tool, every one found by us and every one fixed. The list is its own count; we do not keep a tally in this sentence, because a number typed by hand beside a list that grows is exactly the kind of unchecked claim this tool exists to catch. We publish them because a scoring tool that has never been wrong is a scoring tool that has not been checked:
HEAD ancestry, so ambient branch state can no
longer add evidence or change coverage. The complete v4-to-v5 delta is published in the
rubric changelog.--help and --version as unknown flags, and read -h as a
directory path. Version 0.1.2 handles both aliases before positional-path parsing and
derives its printed version from the package manifest.0.0,
"Unverified". Every real legacy repository has a deploy script, so the fix that passed every
test was unreachable for essentially all of them. Recognised source must now be dominant,
not merely present. A fixture cleaner than reality proves nothing.test.js convention. A smoke test against
sindresorhus/slugify reported that a runner was configured but no concrete test files were
detected even though test.js was present at the repository root. That was a detection gap
in Cejel, not evidence about the repository. Rubric v6 recognizes AVA's test.js and
test-*.js conventions; a regression fixture preserves the correction.nyc. The detector looked only for standalone coverage files and framework configuration.
Version 0.1.10 also recognizes actual nyc, c8, and Istanbul commands or configuration in
package.json. An unused dependency is not treated as coverage evidence. This removes a false
finding without changing the measured coverage score.info finding severity could appear beside a critical dimension
band without naming the two different concepts. Version 0.1.10 prints the two lowest
contributing measurements, concrete next actions, finding severity, and dimension band
explicitly. It also explains when a requested scan target is gitignored instead of presenting
the target as a generic empty repository.Every one was a trust failure produced by us β false alarms about other people's code, silent omissions, inconsistent presentation, or a home-only scoring path β and we would rather you knew that than discovered it. If you believe the board scores your repository wrongly, open an issue β a rubric that cannot be corrected in public has no business being published in public.
No rubric change re-scores you silently. Every change to scoring behavior requires a
WITAN_RUBRIC_VERSION bump and a corpus-wide before/after delta published in
docs/leaderboard/RUBRIC_CHANGELOG.md β score,
verdict, and rank for every repository, "no repository moved" stated explicitly when that is
the result. A build that changes scoring without both fails; see that file's v2 entry for
the home-field fix above as the first rubric change recorded this way.
cejel is free and licensed under AGPL-3.0-only, copyleft: any modified
version you distribute or run as a network service must also make its source available
under the same terms. A commercial license is available for teams that need to use or
modify cejel without those copyleft obligations.
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/cejel)<a href="https://allmcps.com/mcp/cejel"><img src="https://allmcps.com/api/badge/cejel?style=directory" alt="Cejel on AllMCPs" /></a>