{"id":51610088,"url":"https://github.com/gpxl/wijzer","last_synced_at":"2026-07-12T07:01:30.065Z","repository":{"id":370676248,"uuid":"1291059871","full_name":"gpxl/wijzer","owner":"gpxl","description":"An OpenWiki-format agent wiki for your codebase, refreshed from git diffs — powered by your Claude subscription (no API keys). Ships /wijzer:init, :update, :ask.","archived":false,"fork":false,"pushed_at":"2026-07-10T06:38:34.000Z","size":376,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-10T08:14:47.698Z","etag":null,"topics":["agent-wiki","claude-code","claude-code-plugin","codebase-documentation","documentation","openwiki","wiki"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gpxl.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":null,"dco":null,"cla":null}},"created_at":"2026-07-06T13:18:39.000Z","updated_at":"2026-07-10T06:38:38.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gpxl/wijzer","commit_stats":null,"previous_names":["gpxl/wijzer"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/gpxl/wijzer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpxl%2Fwijzer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpxl%2Fwijzer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpxl%2Fwijzer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpxl%2Fwijzer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gpxl","download_url":"https://codeload.github.com/gpxl/wijzer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gpxl%2Fwijzer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35384619,"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-12T02:00:06.386Z","response_time":87,"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":["agent-wiki","claude-code","claude-code-plugin","codebase-documentation","documentation","openwiki","wiki"],"created_at":"2026-07-12T07:01:29.349Z","updated_at":"2026-07-12T07:01:30.059Z","avatar_url":"https://github.com/gpxl.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# wijzer\n\n**An OpenWiki for your codebase, powered by your Claude subscription — no API keys.**\n\n`wijzer` (Dutch: *signpost* / *wiser*) is a [Claude Code](https://claude.com/claude-code)\nplugin that generates and maintains an agent-facing wiki for a repository, and\nkeeps it fresh from your git history. Coding agents read the wiki for grounded\ncontext before they touch a subsystem.\n\nIt reaches **format + behavior parity** with\n[OpenWiki](https://github.com/langchain-ai/openwiki) — the generated `openwiki/`\nfolder, the `.last-update.json` state, and the update algorithm are\ninterchangeable between the two tools — with one deliberate difference:\n\n\u003e **OpenWiki calls an LLM provider and needs an API key.** wijzer runs *inside*\n\u003e Claude Code, so the inference is your existing **Claude Pro/Max subscription**.\n\u003e There is no key to configure and no per-token bill. (This is also the only\n\u003e ToS-legitimate way to use a Claude subscription for this — a plugin doesn't\n\u003e offer login, Claude Code is the runtime.)\n\n## Install\n\n```\n/plugin marketplace add gpxl/wijzer\n/plugin install wijzer@wijzer\n```\n\n## Use\n\n| Command | What it does |\n|---|---|\n| `/wijzer:init [focus]` | Generate the wiki from scratch into `openwiki/`, and add a pointer block to your `AGENTS.md` / `CLAUDE.md`. |\n| `/wijzer:update [instruction]` | Refresh the wiki from what changed since the last run. No-ops cleanly when nothing meaningful changed. |\n| `/wijzer:ask \u003cquestion\u003e` | Answer a question from the wiki, with source-map citations. Never modifies the wiki. |\n\n### Headless / CI\n\nBecause the commands are just skills, you can run them non-interactively:\n\n```\nclaude -p \"/wijzer:update\"\n```\n\n`examples/github-action.yml` shows a scheduled refresh that opens a PR, using\nAnthropic's official [claude-code-action](https://github.com/anthropics/claude-code-action)\nwith a subscription OAuth token (`claude setup-token`) — no API key in CI either.\n\n## How it works\n\nwijzer splits deterministic bookkeeping from model judgment:\n\n- **`scripts/`** — dependency-free bash (git + coreutils) that owns the\n  exact-semantics bookkeeping: the update no-op verdict (`check-noop`), the\n  content snapshot (`snapshot`), the state file (`write-state`), and the output\n  format gate (`check-format`). Each emits one JSON object; each is unit-tested\n  against real temp git repos (`npm test`).\n- **`skills/` + `agents/`** — the model does discovery, git inspection, page\n  planning, writing, and the `AGENTS.md`/`CLAUDE.md` pointer **prompt-driven**,\n  obeying the disciplines in `references/` (generated from OpenWiki's own prompt)\n  and calling the scripts above for the bookkeeping.\n\nSee [PARITY.md](PARITY.md) for exactly what matches OpenWiki and how it's\nverified, and [`CONTRIBUTING`](#contributing) below to hack on it.\n\n## Requirements\n\n- Claude Code with an active Claude subscription.\n- `git` and a POSIX shell. On Windows, use Git Bash or WSL.\n- **No Node.js at runtime.** The plugin is skills + dependency-free bash; nothing\n  it runs for you needs `node`. Node is a **development/CI-only** dependency —\n  it's used to run the Vitest suite and to regenerate `references/disciplines.md`\n  and `references/wiki-format.md` from the vendored OpenWiki prompt (the committed\n  output ships in the plugin, so you never run the generator).\n\n## Contributing\n\nNode is needed here (dev/CI only), not by end users:\n\n```\nnpm install\nnpm test          # Vitest: scripts vs temp git repos + the vendored OpenWiki parity tests\nnpm run lint      # shellcheck\n```\n\nWhen OpenWiki evolves, re-derive the generated doctrine and re-prove parity:\n\n```\nscripts/vendor-openwiki.sh --sha \u003cnew\u003e        # re-vendor the spec at a new SHA\nnode scripts/build-disciplines.mjs            # regenerate the reference docs\nnpm test                                      # cross-validation re-proves parity\n```\n\nContributions welcome — especially parity fixes when OpenWiki evolves (see the\nre-validation procedure in [PARITY.md](PARITY.md)).\n\n## License \u0026 lineage\n\nMIT. wijzer is an independent reimplementation; none of OpenWiki's source runs in\nits runtime (skills + bash). The wiki format, state schema, update algorithm,\nprompt disciplines, and test structure are adapted from OpenWiki (MIT, © LangChain,\nInc.), and a pinned snapshot of a few OpenWiki files is vendored under\n[vendor/openwiki/](vendor/openwiki/) for dev/CI parity verification — see the\nattribution in [NOTICE](NOTICE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgpxl%2Fwijzer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgpxl%2Fwijzer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgpxl%2Fwijzer/lists"}