← ClaudeAtlas

shellbrainlisted

Use when an agent should remember to ask Shellbrain for targeted recall at task start, subproblem changes, repeated failures, hypothesis changes, or closeout.
cucupac/shellbrain · ★ 10 · AI & Automation · score 67
Install: claude install-skill cucupac/shellbrain
# Shellbrain Recall Workflow ## Purpose Shellbrain is a persistent memory system for agent work. As the working agent, your interface is: ```bash shellbrain recall ``` Recall returns a compact brief synthesized from prior memories, concepts, scenarios, and recent episode context. It is meant to reduce wasted exploration and help you decide where to look next. When the user explicitly asks you to store or teach Shellbrain something, use: ```bash shellbrain teach ``` Teach stores the user-provided statement as evidence and immediately asks Shellbrain's teach agent to turn it into durable memories or concept graph updates. Do not call Shellbrain internal commands directly. `read`, `events`, `memory`, `concept`, and `scenario` are for Shellbrain's internal agents. ## Quick Start Do not run `shellbrain init` at the start of every session. Use this order: 1. If Shellbrain is missing or broken, run `shellbrain admin doctor`. 2. If doctor says repair is needed, run `shellbrain init`. 3. Otherwise, use `shellbrain recall` with a targeted query and `current_problem`. If `shellbrain` is not found, do a one-time PATH check: ```bash zsh -lc 'source ~/.zprofile >/dev/null 2>&1; command -v shellbrain' ``` If the host shell is bash instead of zsh, use: ```bash bash -lc 'source ~/.bash_profile >/dev/null 2>&1; command -v shellbrain' ``` Once found, use plain `shellbrain ...`. Do not keep sourcing the login profile on every Shellbrain command. If the one-time login-shell ret