{"id":51384740,"url":"https://github.com/creatornader/atrib-log-pp-cli","last_synced_at":"2026-07-03T19:09:24.369Z","repository":{"id":358444337,"uuid":"1241428637","full_name":"creatornader/atrib-log-pp-cli","owner":"creatornader","description":"Developer CLI for the atrib transparency log at log.atrib.dev. Generated by Printing Press. Complementary to the @atrib/* MCP cognitive primitives.","archived":false,"fork":false,"pushed_at":"2026-05-24T12:27:15.000Z","size":188,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T14:09:58.695Z","etag":null,"topics":["atrib","claude-code","cli","go","mcp","printing-press","sigsum","transparency-log"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/creatornader.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-17T11:31:26.000Z","updated_at":"2026-05-24T12:27:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/creatornader/atrib-log-pp-cli","commit_stats":null,"previous_names":["creatornader/atrib-log-pp-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/creatornader/atrib-log-pp-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creatornader%2Fatrib-log-pp-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creatornader%2Fatrib-log-pp-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creatornader%2Fatrib-log-pp-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creatornader%2Fatrib-log-pp-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/creatornader","download_url":"https://codeload.github.com/creatornader/atrib-log-pp-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creatornader%2Fatrib-log-pp-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35097961,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-03T02:00:05.635Z","response_time":110,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["atrib","claude-code","cli","go","mcp","printing-press","sigsum","transparency-log"],"created_at":"2026-07-03T19:09:21.276Z","updated_at":"2026-07-03T19:09:24.361Z","avatar_url":"https://github.com/creatornader.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# atrib-log-pp-cli\n\nDeveloper CLI for the [atrib](https://github.com/creatornader/atrib) transparency log at `log.atrib.dev`. Wraps the public log API (signed checkpoint, log public keys, stats, recent entries, lookup by hash, inclusion-proof recovery, by context, by creator, JSON Feed, SSE stream, Merkle tile retrieval) with local SQLite mirroring, full-text search, and agent-friendly defaults.\n\nGenerated by [Printing Press](https://github.com/mvanhorn/cli-printing-press) from a hand-authored OpenAPI spec for `log.atrib.dev`.\n\n## What this is and isn't\n\n**This is** the developer-facing CLI for direct interaction with `log.atrib.dev`. Use it for batch queries, verification, debugging, dogfooding the public log API, and one-off \"show me the last N entries by signer X\" type questions.\n\n**This is NOT** a replacement for the [`@atrib/*`](https://github.com/creatornader/atrib) MCP cognitive primitives (`emit`, `annotate`, `revise`, `recall`, `trace`, `summarize`, `verify`). Those are the agent-facing surface, designed around the seven primitives an agent reasons in. This CLI is the operator-facing surface, designed around the HTTP API endpoints. They are complementary:\n\n- Agent doing cognitive work → use the MCP primitives\n- Human or script interacting with the log → use this CLI\n\n## Install\n\nThe CLI is a Go binary. Install with `go install`:\n\n```sh\ngo install github.com/creatornader/atrib-log-pp-cli/cmd/atrib-log-pp-cli@latest\n```\n\nOr build from source:\n\n```sh\ngit clone https://github.com/creatornader/atrib-log-pp-cli\ncd atrib-log-pp-cli\ngo build ./cmd/atrib-log-pp-cli\n./atrib-log-pp-cli --help\n```\n\nThe binary lands in `$GOPATH/bin` (typically `~/go/bin/`). Ensure that's on your `PATH`.\n\n## Use\n\n```sh\n# Live API queries\natrib-log-pp-cli checkpoint              # signed tree head\natrib-log-pp-cli log-pubkey              # C2SP signed-note vkey\natrib-log-pp-cli stats                   # tree size + entries by event type\natrib-log-pp-cli recent --limit 10       # most recent entries\natrib-log-pp-cli lookup \u003crecord-hash\u003e    # entry by hash\natrib-log-pp-cli proof \u003crecord-hash\u003e     # recover inclusion proof\natrib-log-pp-cli by-context \u003ccontext-id\u003e # all entries in a session\natrib-log-pp-cli by-creator \u003ckey\u003e        # all entries by signer\natrib-log-pp-cli feed-json --limit 10    # JSON Feed 1.1\natrib-log-pp-cli stream                  # raw Server-Sent Events\n\n# Local mirror + search\natrib-log-pp-cli sync                    # mirror to local SQLite\natrib-log-pp-cli search \"query string\"   # FTS over the mirror\n\n# Compound workflows\natrib-log-pp-cli workflow                # multi-step operations\natrib-log-pp-cli analytics               # group-by + summary queries\n\n# Agent-friendly defaults\natrib-log-pp-cli --agent recent          # sets --json --compact --no-input --no-color --yes\n```\n\n`atrib-log-pp-cli doctor` checks auth + connectivity. `atrib-log-pp-cli api` browses the full endpoint catalog. `atrib-log-pp-cli which \u003ccapability\u003e` finds the command that implements a given capability.\n\n## MCP server\n\nThe CLI ships a paired MCP server (`atrib-log-pp-mcp`) for agents that prefer MCP over CLI invocation. Build it the same way:\n\n```sh\ngo build ./cmd/atrib-log-pp-mcp\n```\n\nConfigure in Claude Desktop's `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"atrib-log\": {\n      \"command\": \"atrib-log-pp-mcp\"\n    }\n  }\n}\n```\n\nThe MCP server exposes the same finite command surface as the CLI. The raw SSE stream command stays CLI-only because MCP tool calls expect a bounded response. Note: for *agent cognitive work* (emitting signed records, recalling past actions, etc.), the [`@atrib/*`](https://github.com/creatornader/atrib) MCP servers are the right surface, not this one.\n\n## Configuration\n\nConfig file: `~/.config/log-atrib-dev-pp-cli/config.toml`. Static request headers configurable under `[headers]`; per-command header overrides take precedence.\n\n## Exit codes\n\n`0` success, `2` usage error, `3` not found, `5` API error, `7` rate limited, `10` config error.\n\n## Regeneration\n\nThis CLI is generated from `spec.yaml` (a hand-authored OpenAPI spec for `log.atrib.dev`) via Printing Press. To regenerate after the API surface changes:\n\n```sh\ngo install github.com/mvanhorn/cli-printing-press/v4/cmd/printing-press@latest\nprinting-press generate --spec ./spec.yaml --name atrib-log --force\n```\n\nThe `--force` flag uses AST-based merge to preserve hand edits to generated files. See the [Printing Press](https://github.com/mvanhorn/cli-printing-press) docs for the full regeneration workflow.\n\n## Related tools\n\nThis CLI is part of the public surface around atrib:\n\n| Repo | Concern |\n|---|---|\n| [`atrib`](https://github.com/creatornader/atrib) | The protocol + the `@atrib/*` MCP primitives + the log service that backs `log.atrib.dev` |\n| [`atrib-log-pp-cli`](https://github.com/creatornader/atrib-log-pp-cli) (this repo) | Developer CLI for the log API |\n| [`textleaks`](https://github.com/creatornader/textleaks) | Narrative-leak detection in text content (pre-commit hook) |\n| [`oss-twin`](https://github.com/creatornader/oss-twin) | Public/private mirror structural plumbing |\n| [`oss-security-scan`](https://github.com/creatornader/oss-security-scan) | Reusable GitHub Actions workflow for typos + gitleaks + trufflehog + osv-scanner |\n\n## License\n\nApache 2.0. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcreatornader%2Fatrib-log-pp-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcreatornader%2Fatrib-log-pp-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcreatornader%2Fatrib-log-pp-cli/lists"}