| name | status |
| description | Check whether llm-wiki is current, detect newer marketplace or Pi package versions, and suggest or run the right update command for Claude Code, Codex, or Pi. Use when the user asks about llm-wiki version, plugin/package updates, marketplace refresh, upgrade instructions, project context setup, or whether a new llm-wiki release is available. |
LLM Wiki Status
Check whether llm-wiki is current and report the exact update command for the current agent environment.
Also inspect project-local wiki configuration when available:
.llm-wiki/config.jsonAGENTS.mdCLAUDE.md.pi/settings.json.claude/settings.json.llm-wiki/refresh-wiki.sh.llm-wiki/post-commit-refresh.sh$(git rev-parse --git-common-dir)/llm-wiki/post-commit-refresh.sh$(git rev-parse --git-common-dir)/llm-wiki/config.json$(git rev-parse --git-common-dir)/llm-wiki/refresh-disabled$(git rev-parse --git-common-dir)/llm-wiki/consecutive-failures$(git rev-parse --git-common-dir)/llm-wiki/pending/$(git rev-parse --git-common-dir)/llm-wiki/failed/refs/llm-wiki/sources/
When the project is bootstrapped, resolve the canonical upgrade script relative
to ../upgrade/SKILL.md and run it with --check. Report exit status 10 as
upgrade available, not as an error. Do not apply the project migration unless
the user explicitly asks to update or upgrade the project-local structure.
Rules
- Detect whether the user is running Claude Code, Codex, Pi, or multiple CLIs are present.
- If the user asks only how to update, give commands without changing anything.
- If the user asks to check the latest version, fetch marketplace or Pi package metadata and compare versions.
- If the user asks to update, run the update command for the active tool and tell them to restart the tool afterward.
- Compare semantic versions with
sort -V when available; otherwise parse major/minor/patch numerically. Do not compare version strings lexicographically.
- If network access, marketplace metadata, or Pi package metadata is unavailable, report the local version and the command that refreshes the relevant metadata.
- If
.llm-wiki/config.json exists, report headless_agent, context_agents, and main_wiki_path.
- Report project structure as
current, upgrade available, or unknown from the bundled upgrade check.
- Inspect refresh state in the shared Git directory. Always count runnable
pending records, hidden interrupted queue records, and quarantined source
records, even when
refresh-disabled is absent. Report the breaker reason
verbatim when present; backlog:<n> means the automatic pending-source bound
opened the circuit before a provider launch, while deferred:<n> means work
arrived outside the last bounded batch and needs an operator-paced retry.
Report the circuit as closed
only when the breaker is absent and the quarantined count is zero; otherwise
report open with the breaker reason, consecutive-failure count, all three
queue counts, queued-source keepalive-ref count, post-commit-refresh.log
path, and exact recovery command
.llm-wiki/post-commit-refresh.sh --retry-failed all. Do not invoke recovery
unless the user explicitly asks to retry. Recovery processes one bounded
batch per invocation, so say when the command must be rerun for remaining
sources.
- Report managed wiki context using the exact
<!-- BEGIN LLM WIKI --> and <!-- END LLM WIKI --> marker pair.
- Classify
AGENTS.md and CLAUDE.md context as managed present, unmanaged wiki section only, missing, or unknown.
- Report Pi context from
AGENTS.md; do not require .pi/SYSTEM.md or .pi/APPEND_SYSTEM.md.
- Report whether Claude SessionStart context appears configured when
.claude/settings.json exists.
- Classify each automation surface as
codex, claude, pi, mixed, missing, mismatch, or unknown.
- For the scheduler and legacy post-commit scripts, ownership is clean only when
the configured owner command is present and the non-owner commands are absent.
codex means codex exec alone is present; claude means claude -p alone
is present; and pi means pi -p or pi --print alone is present. More than
one owner command is mixed; exactly one command for a different configured
owner is mismatch.
- The canonical post-commit template is different by design: it contains all
three provider commands behind a runtime
headless_agent dispatcher. Resolve
../../templates/post-commit-refresh.sh relative to this SKILL.md. When the
project copy is byte-for-byte equal to that bundled template, classify its
owner from a validated .llm-wiki/config.json value (codex, claude, or
pi), not by scanning provider command tokens. An absent or unsupported
configured owner is unknown. Use the command-token rules only for a
non-canonical legacy post-commit script.
- The managed hook should invoke the canonical runner under the shared Git
directory with
--project and the committing worktree root. Report
checkout-local-only invocation as upgrade available, because linked
worktrees can otherwise retain stale ignored scripts.
- Count managed
llm-wiki hook or scheduler entries when possible. The
canonical dispatcher is clean only when exactly one managed hook block calls
it; report missing or duplicate managed entries instead of treating the
dispatcher itself as proof that the hook is healthy.
- Report exactly one project upgrade command for the active agent surface:
/llm-wiki:upgrade for Claude Code, $llm-wiki:upgrade for Codex, or
/skill:wiki-upgrade for Pi. If the active surface cannot be determined,
report the command as unknown; do not list all three alternatives.
Claude Code
Useful commands:
claude plugin marketplace update aikuznetsov-marketplace
claude plugin update llm-wiki
claude plugin list --json --available
Status workflow:
- Run
claude plugin list --json --available when available.
- Find
llm-wiki by name, id, or plugin fields.
- Compare installed/current and available/latest versions.
- If a newer version exists, suggest:
claude plugin marketplace update aikuznetsov-marketplace
claude plugin update llm-wiki
Tell the user that Claude Code must be restarted for the updated plugin to load.
Codex
Codex currently exposes marketplace refresh, not a first-class plugin list or plugin update <plugin> command.
Useful command:
codex plugin marketplace upgrade aikuznetsov-marketplace
Local version paths:
find ~/.codex/plugins/cache/aikuznetsov-marketplace/llm-wiki -mindepth 1 -maxdepth 1 -type d -exec basename {} \; | sort -V | tail -n1
jq -r '.version' ~/.codex/.tmp/marketplaces/aikuznetsov-marketplace/plugins/llm-wiki/.codex-plugin/plugin.json
Remote marketplace check:
curl -fsSL https://raw.githubusercontent.com/ivankuznetsov/agent-plugins/main/.claude-plugin/marketplace.json \
| jq -r '.plugins[] | select(.name == "llm-wiki") | .version'
Status workflow:
- Read the local cached version from
~/.codex/plugins/cache/aikuznetsov-marketplace/llm-wiki/.
- Read the cached marketplace version from
~/.codex/.tmp/marketplaces/aikuznetsov-marketplace/plugins/llm-wiki/.codex-plugin/plugin.json when it exists.
- Fetch the remote marketplace version with
curl when the user wants to know whether a new release is out.
- If the remote version is newer than the local cached version, suggest:
codex plugin marketplace upgrade aikuznetsov-marketplace
Tell the user that Codex must be restarted for the updated plugin to load.
Pi
Pi uses Pi packages instead of the Claude/Codex plugin marketplace. The Pi package exposes prefixed skill names to avoid global /skill:name collisions:
/skill:wiki-bootstrap
/skill:wiki-upgrade
/skill:wiki-research
/skill:wiki-plan
/skill:wiki-status
Useful commands:
pi --version
pi list
pi update git:github.com/ivankuznetsov/llm-wiki
pi update --extensions
Remote package version check:
curl -fsSL https://raw.githubusercontent.com/ivankuznetsov/llm-wiki/main/package.json \
| jq -r '.version'
Status workflow:
- Run
pi --version when available.
- Run
pi list when available and look for an installed llm-wiki package or source.
- Read the local package version from
package.json when running from the llm-wiki checkout.
- Fetch the remote package version from the GitHub
package.json when the user wants to know whether a new release is out.
- If the remote version is newer than the installed/local version, suggest:
pi update git:github.com/ivankuznetsov/llm-wiki
If Pi reports the package under a different installed source, use that exact source with pi update <source>. Tell the user to restart Pi after updating package skills.
Report Format
Return:
**llm-wiki Plugin Status**
- Current cached/installed version: ...
- Latest marketplace/package version: ...
- Status: current | update available | unknown
- Update command: ...
- Restart required: yes | no
- Headless agent: claude | codex | pi | unknown
- Context agents: ...
- AGENTS.md wiki context: managed present | unmanaged wiki section only | missing | unknown
- CLAUDE.md wiki context: managed present | unmanaged wiki section only | missing | unknown
- Pi wiki context: AGENTS.md managed present | missing | unknown
- Claude SessionStart context: present | missing | not checked
- Scheduled refresh owner: claude | codex | pi | mixed | missing | mismatch | unknown
- Post-commit refresh owner: claude | codex | pi | mixed | missing | mismatch | unknown
- Project structure: current | upgrade available | unknown
- Project upgrade command: <active surface's single command> | unknown
- Refresh circuit: closed | open (reason: <value>, failures: <n>, pending: <n>, interrupted: <n>, quarantined: <n>, pinned: <n>) | unknown
- Refresh recovery command: .llm-wiki/post-commit-refresh.sh --retry-failed all | not needed | unknown
- Refresh log: <shared-git-dir>/llm-wiki/post-commit-refresh.log | unknown
Mention whether the result came from local cache only or from a remote marketplace/package check.
