Status

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.json
• AGENTS.md
• CLAUDE.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: means the automatic pending-source bound opened the circuit before a provider launch, while deferred: 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 ` and ` 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 non-canonical legacy scheduler and 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 scheduled template contains no provider command. Resolve

../../templates/refresh-wiki.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, as for the canonical post-commit template. A non-canonical wrapper is project-structure drift; report the upgrade check's upgrade available result rather than treating the absence of provider command tokens as a missing owner.

• 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.

• For Linux systemd, resolve the primary worktree and report healthy only when

the repository has one X-LLMWikiManaged=yes timer/service pair, the timer omits Persistent=true, and the service contains a machine-wide lock, MemoryMax=4G, and MemorySwapMax=0. Duplicate linked-worktree units or a direct checkout writer mean upgrade available.

• 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:

1. Run claude plugin list --json --available when available.
2. Find llm-wiki by name, id, or plugin fields.
3. Compare installed/current and available/latest versions.
4. 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 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:

1. Read the local cached version from ~/.codex/plugins/cache/aikuznetsov-marketplace/llm-wiki/.
2. Read the cached marketplace version from ~/.codex/.tmp/marketplaces/aikuznetsov-marketplace/plugins/llm-wiki/.codex-plugin/plugin.json when it exists.
3. Fetch the remote marketplace version with curl when the user wants to know whether a new release is out.
4. 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:

1. Run pi --version when available.
2. Run pi list when available and look for an installed llm-wiki package or source.
3. Read the local package version from package.json when running from the llm-wiki checkout.
4. Fetch the remote package version from the GitHub package.json when the user wants to know whether a new release is out.
5. 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 . 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:  | unknown
- Refresh circuit: closed | open (reason: , failures: , pending: , interrupted: , quarantined: , pinned: ) | unknown
- Refresh recovery command: .llm-wiki/post-commit-refresh.sh --retry-failed all | not needed | unknown
- Refresh log: /llm-wiki/post-commit-refresh.log | unknown

Mention whether the result came from local cache only or from a remote marketplace/package check.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ivankuznetsov
• Source: ivankuznetsov/llm-wiki
• License: MIT

Install and usage instructions live in the source repository linked above.