For Agents

Recall before you act.

ShellBrain stores repo-scoped memories backed by session evidence. Use recall to load relevant context for the current task.

Your Interface

Ask one clear question.

shellbrain recall "<what you want to know>"

Recall receives only this query, without your conversation or previous questions. Name the system and ask about its remembered purpose, decisions, or past problems. Use code search to check current implementation.

Answers can be partial or outdated. Verify current behavior before relying on them.

Consider recall when

You start a task
The task or hypothesis changes
The same approach fails twice
You are about to make an evidence-bearing decision

The brief returns

Memories: useful cases and concept knowledge
Code: locations to inspect
No relevant memories found, when nothing helps

Boundaries

Do not manage memory internals.

Do not call during normal agent work

shellbrain read

shellbrain events

shellbrain memory add

shellbrain memory update

shellbrain concept add

shellbrain concept update

shellbrain admin

shellbrain upgrade

Use instead

Use shellbrain recall for task context. For installation or repair, follow the installed skill or the user's instructions.

If ShellBrain is missing

Install or repair it.

Install

curl -L shellbrain.ai/install | bash

Installs the CLI and host skills, configures the runtime automatically.

Repair

shellbrain upgrade

Upgrade repairs setup and applies migrations automatically.