catalog / cli

JSON Tool CLI

Query, filter and reshape JSON from a pipe, with exit codes that mean something.

12 capabilities 2 sections reference specification

Build against it

# give your agent the catalog — no account, no install
claude mcp add provespec -- npx -y provespec-mcp

# then, from any agent session
spec_get(slug: "json-tool-cli")                → the capability tree
spec_checklist(slug: "json-tool-cli")          → the questions to answer
spec_grade(slug: "json-tool-cli", grades: [...])  → parity % + the gap list

# or just fetch it
curl https://provespec.com/catalog/json-tool-cli/spec.json

Grade every capability below as yes · partial · no · na, with a file reference as evidence. Whatever you leave ungraded counts as missing — the gap list is the work queue.

Or just paste this to your agent

Use the ProveSpec MCP server. Fetch the "json-tool-cli" spec with
spec_get, then walk spec_checklist and grade this repository against it —
one verdict per capability, each with a file reference as the note.
Call spec_grade with the results and give me the gap list as the plan.

If the server is not registered, add it first:
  claude mcp add provespec -- npx -y provespec-mcp

The specification

AI 8

Core
  • Pretty-print / format configurable indent stable key order preserved
  • Minify
  • Validate with precise errors line:col + context nonzero exit on invalid
  • Sort keys (optional) --sort-keys recursive, stable
Query
  • Path query subset .a.b[0], .[] jq-lite: field access, index, iterate
IO
  • stdin/stdout piping composable in pipelines
  • File input and in-place edit -i with backup atomic write
  • Large-file streaming does not load entire input for format/minify

UI 4

CLI
  • Help and version --help, --version examples in help
  • Meaningful exit codes 0 ok, 1 invalid, 2 usage
  • Color output on TTY auto; --no-color respects NO_COLOR
  • Quiet mode -q validate only
Download spec.json All 53 specs