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

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 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.
• Scheduler and post-commit ownership are clean only when the configured owner command is present and the non-owner command is absent.
• codex means codex exec is present and claude -p, pi -p, and pi --print are absent.
• claude means claude -p is present and codex exec, pi -p, and pi --print are absent.
• pi means pi -p or pi --print is present and codex exec and claude -p are absent.
• mixed means more than one owner command is present.
• mismatch means exactly one owner command is present but it is not the configured headless_agent.
• Count managed llm-wiki hook or scheduler entries when possible; report duplicates as mixed or mismatch rather than clean.

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

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

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