crabshell

Runs Obsidian lint checks on .crabshell/ documents and reports violations. Use when you want to verify document health: missing frontmatter, broken wikilinks, INDEX.md sync issues, orphaned files. Invoke with /lint to run checks, or /lint fix to auto-apply safe fixes.

BM25 full-text search across all D/P/T/I/H/W/K documents in .crabshell/. Returns ranked results by relevance. Use when looking for specific discussions, plans, tickets, or investigations by topic keyword. Invoke with /search-docs <query>.

Creates project-specific verification tools when they don't exist, or runs existing ones against Intent Anchor items. Use when verification is needed and no project verification tool exists. Invoke with /verifying to create verification manifest, or /verifying run to execute existing tools.

Create a Crabshell K knowledge page from Codex. Use for verified facts and operational tips discovered through project work.

Create and run a Crabshell I investigation document from Codex. Use for evidence-heavy research that needs multiple source types, cross-review, and documented conclusions; not for quick questions.

Convert CLAUDE.md instructions into Codex-oriented AGENTS.md guidance. Use when the user wants Claude project rules made available to Codex.

Create a Crabshell D discussion document from Codex. Use for design discussion, decisions, and intent anchors.

Record a small completed fix in a Crabshell H hotfix document. Use for narrow fixes that do not need a full W or D/P/T workflow.

Create and maintain a lightweight Crabshell W worklog for a standalone Codex task. Use when the user asks for light workflow or wants traceable one-shot work.

Load Crabshell project memory into the current Codex conversation. Use when the user asks to load memory, resume context, or inspect saved project notes.

Create a Crabshell P plan document from Codex. Use when a task needs an implementation plan before tickets.

Run a Codex-compatible D/P/T iterative improvement workflow. Use when the task needs repeated plan-execute-verify cycles rather than a one-shot worklog.

Save an explicit Codex session note to Crabshell memory. Use when the user asks to remember, save context, or persist decisions.

Search Crabshell memory and archived session context. Use when the user asks what happened before or asks to find prior decisions.

Create a Crabshell T ticket document from Codex. Use for session-sized executable work tied to a plan.

Runs convergence-based iterative optimization cycles wrapped by a single Discussion. Use when a topic needs repeated improvement through plan-execute-verify-feedback loops. Invoke with /regressing "topic" N (N = cycle cap, not target). Cycles continue until convergence or cap. Not for one-shot tasks — use light-workflow instead.

Creates and updates ticket documents as executable work units tied to a plan. Use when breaking a plan into session-sized tasks with acceptance criteria and verification steps. Invoke with /ticketing P001 "topic" to create, or /ticketing P001_T001 to update. Each ticket executes independently with Work Agent, Review Agent, and Orchestrator.

Runs a healthcheck of the Crabshell plugin state. Reports memory, regressing, verification, counter values, and plugin version with ✓/!/✗ indicators. Invoke with /status.

Record lightweight hotfixes. Use for one-line fixes that don't warrant light-workflow. Invoke with /hotfix "description" to create, or /hotfix H001 to update.

Create and manage project-specific knowledge pages in .crabshell/knowledge/. Stores verified facts and operational tips discovered through project work. Invoke with /knowledge 'title' to create, or /knowledge K001 to view.

Creates and updates discussion documents for recording decisions and ongoing dialogues. Use when starting a new discussion, recording a decision, or when the regressing skill needs a top-level container. Invoke with /discussing "topic" to create, or /discussing D001 to update. Not for investigation — use investigating skill instead.

Conducts multi-agent investigations using internet, local, and user-specified sources with cross-review and structured I-document output. Use when thorough investigation of a topic is needed with evidence from multiple sources. Invoke with /investigating "topic" to create, or /investigating I001 to update. Not for quick questions — use normal conversation instead.

Provides lightweight agent orchestration for standalone one-shot tasks with worklog tracing. Use when a simple task needs Work Agent + Review Agent + Orchestrator but does not require D/P/T documentation. Invoke with /light-workflow. Not for iterative work — use regressing instead.

Creates and updates structured plan documents with agent-verified execution strategy. Use when establishing an implementation plan after a discussion, or when breaking work into steps before ticketing. Invoke with /planning "topic" to create, or /planning P001 to update. Not for direct execution — create tickets first.

Auto-generates project.md from codebase analysis (package.json, README.md, git remote). Creates a 2-3 sentence project concept that is injected every prompt for drift prevention. Use when project.md doesn't exist or needs updating. Invoke with /setup-project.

Auto-executes when the [CRABSHELL_DELTA] trigger is detected. Calls delta-summarizer agent to summarize and append to logbook.md. Not user-invocable — triggered automatically.

Install and configure RTK (Rust Token Killer) for CLI output compression. Opt-in utility — detects OS, downloads binary, adds to PATH, runs rtk init -g. Invoke with /setup-rtk.

Archives or clears old memory session files to manage storage. Use when memory files accumulate and need cleanup, compression, or archival. Invoke with /clear-memory.

Loads full hierarchical memory context including project info, L3 summaries, and rolling memory. Use after session restart, context compaction, or when memory context feels incomplete or stale. Invoke with /load-memory.

Auto-executes when the [CRABSHELL_SAVE] trigger is detected in hook output. Saves session memory following a numbered step sequence. Not user-invocable — triggered automatically by the plugin system.

Auto-executes when the [CRABSHELL_ROTATE] trigger is detected, rotating logbook.md when it exceeds token limits. Calls Haiku agent for summarization of rotated content. Not user-invocable — triggered automatically.

Manually saves the current session context to memory files on demand. Use when explicitly asked to save progress, or when important decisions need to be preserved immediately rather than waiting for auto-save. Invoke with /save-memory. Not for routine saves — memory-autosave handles those automatically via triggers.

Searches past sessions, memory archives, and session history for keywords, decisions, or context. Use when looking up previous session content, finding historical decisions, or querying memory by topic. Invoke with /search-memory "keyword".