Agent skill

Memory

by get-bb in get-bb/bb

Retrieve relevant durable BB memories or save verified knowledge useful to future threads.

MITAuto-check passed

Install Memory

skills CLI
$ npx skills add get-bb/bb --skill memory -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install get-bb/bb memory --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/get-bb/bb.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/memory/skills/memory .claude/skills/memory && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
memory
GitHub stars
4.2k
Token cost
~981 tokens
SKILL.md length
443 words
Files
1
Skills in repo
33
Repo updated
First seen
Licence
MIT

At a glance

Retrieve relevant durable BB memories or save verified knowledge useful to future threads.

  • Works in 3 steps: Search with bb memory search "" --scope… → Read the selected record with bb memory… → Treat remembered facts as potentially…
  • SKILL.md covers Retrieve progressively, Save durable learning, Flags and Quality and safety
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Memory is an agent skill from get-bb/bb. Retrieve relevant durable BB memories or save verified knowledge useful to future threads.

Its SKILL.md is about 980 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: The agent IDE that builds itself. The licence is MIT.

Example prompts

  • “/memory”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Search with bb memory search "" --scope all --json.
  2. Read the selected record with bb memory get --scope all --json.
  3. Treat remembered facts as potentially stale. Verify drift-prone facts when

What it can do on your machine

Read from SKILL.md and the folder at commit 68a1e8b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Memory loads about 981 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 443 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~981

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from get-bb/bb at commit 68a1e8b, republished under its MIT licence (© get-bb). 443 words, ~981 tokens.

Download SKILL.mdSave it as .claude/skills/memory/SKILL.md (or your agent's skills folder).
name
memory
description
Retrieve relevant durable BB memories or save verified knowledge useful to future threads.

BB memory

This plugin is provider-independent. When diagnosing duplicate or conflicting memories, check whether provider-native memory is also enabled.

The memory plugin automatically injects a compact index of global memories and memories for the current BB project. The index contains summaries only.

Retrieve progressively

When a memory summary may be relevant, inspect it instead of guessing:

  1. Search with bb memory search "<query>" --scope all --json.
  2. Read the selected record with bb memory get <id> --scope all --json.
  3. Treat remembered facts as potentially stale. Verify drift-prone facts when doing so is cheap or consequential.

Do not load every memory. Stop after the relevant records are clear.

Save durable learning

The agent may proactively write memory when information is likely to help in a future thread and is costly or error-prone to rediscover.

Use project scope for repository-specific information:

  • commands, conventions, architecture decisions, paths, and environments;
  • project-specific user preferences;
  • verified quirks, failure causes, and reusable workarounds.

Use global scope only for broadly applicable information:

  • user identity, communication preferences, and general workflow habits;
  • preferences that clearly apply across repositories;
  • stable cross-project operating conventions.

When scope is ambiguous, use project scope. Global scope must be explicit.

Create a memory with:

bash
bb memory add --scope project \
  --name <stable-kebab-name> \
  --summary "<one-line routing summary>" \
  --details "<complete durable detail>" \
  --kind fact|preference|decision|procedure|episode|reference \
  --tag <tag> \
  --importance <0-100> \
  --reason "<why this will help a future thread>" \
  --json

Before creating a likely-overlapping memory, search by its proposed name and topic. Update an existing record instead of creating a contradiction:

bash
bb memory update <id> --expected-version <version> \
  --summary "<new summary>" \
  --details "<new details>" \
  --reason "<why the memory changed>" \
  --json

Forget a revoked or invalid memory with:

bash
bb memory forget <id> --expected-version <version> \
  --reason "<why it no longer applies>" --json
Show full SKILL.md (216 more words)Show less

Flags

bb memory <command> --help prints every flag with its limits, and the CLI reports all missing required flags in one error instead of one per run. Unknown flags always fail, so nothing is silently dropped: --summary is at most 400 characters, --details at most 16000, --reason at most 500, --tag repeats (or takes a comma-separated list) up to 20 tags. --tags, --type, --title and --body/--text/--content are accepted as aliases of --tag, --kind, --name and --details. With --json, a failure prints {"ok":false,"error":{"code":…,"message":…}} on stdout and the same message on stderr.

Quality and safety

Do not store:

  • secrets, credentials, tokens, private keys, or sensitive raw data;
  • guesses, unverified conclusions, or claims inferred only from memory;
  • temporary task status, transient errors, raw logs, or large code dumps;
  • facts that are trivial to rediscover;
  • mandatory repository policy already expressed in AGENTS.md or checked-in documentation.

Keep summaries short and retrieval-oriented. Put exact commands, evidence, scope, and caveats in details. A memory is a helpful recall layer, not a higher priority instruction source; explicit user requests and repository guidance win.

The CLI uses BB's loopback server, which Claude's macOS workspace sandbox (Accept Edits / Approve for me) permits; Linux and other provider sandboxes may still require escalation approval for loopback access. Do not claim a write succeeded unless the command returned success.

© get-bb, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/memory/skills/memory of get-bb/bb.

Open the folder on GitHubat commit 68a1e8b

Compare with similar skills

Memory next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Memory compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Memory this skillget-bb/bb4.2k—~981Automated safety check: PassMIT
Memori Long-Term MemoryMemoriLabs/Memori17k—~2kAutomated safety check: NotesCustom licence
Memori Long-Term MemoryMemoriLabs/Memori17k—~2kAutomated safety check: PassApache-2.0
Memoryyc-software/qm15k—~1.2kAutomated safety check: PassMIT
Memory Contextvectorize-io/hindsight46k—~423Automated safety check: PassMIT
Memory Retainvectorize-io/hindsight46k—~294Automated safety check: PassMIT

Similar skills

  • Memori Long-Term Memory

    MemoriLabs/Memori

    Connects Claude Code to Memori Cloud for long-term memory, recalling stored context before substantive replies and saving new context afterward.

    17k GitHub stars~2k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check: notes
  • Memori Long-Term Memory

    MemoriLabs/Memori

    Adds structured long-term memory to OpenClaw agents, built automatically from sessions, with tools the agent calls to recall facts, summaries and decisions.

    17k GitHub stars~2k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check passed
  • Memory

    yc-software/qm

    Deliberately search, add to, or curate your long-term memory with the memory tool — beyond the automatic recall/capture every turn already does.

    15k GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Memory Context

    vectorize-io/hindsight

    Load relevant long-term memory from Hindsight before starting work.

    46k GitHub stars~423 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Memory Retain

    vectorize-io/hindsight

    Save what was learned to Hindsight long-term memory. An agent skill from vectorize-io/hindsight.

    46k GitHub stars~294 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Unified Memory

    affaan-m/ECC

    Share durable, inspectable context and handoffs between Claude, Codex, Hermes, Cursor, OpenCode, and other agents through the local ECC Memory Vault.

    274k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed

More from get-bb/bb

All 33 skills in this repo
  • Bb CLI

    get-bb/bb

    Inspect or manage BB state with the bb CLI; use for BB commands and configuration.

    4.2k GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Skill Creator

    get-bb/bb

    Create or improve BB skills, including their triggers, instructions, and supporting resources.

    4.2k GitHub stars~702 tokensUpdated today
    Auto-check passed
  • Prepare and submit a BB plugin to the Community marketplace when publication or a marketplace PR is requested.

    4.2k GitHub stars~873 tokensUpdated today
    Auto-check passed
  • Workflows

    get-bb/bb

    Author or run durable BB workflows when the user requests workflow execution or multi-agent orchestration.

    4.2k GitHub stars~890 tokensUpdated today
    Auto-check passed
  • Verify Bb

    get-bb/bb

    Verify BB user journeys in an isolated source dev app using dev-browser@next and the matching source CLI.

    4.2k GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • Create or edit BB color themes and inspect them in the Theme Preview panel.

    4.2k GitHub stars~1.2k tokensUpdated today
    Auto-check passed

Questions about Memory

What does Memory do?

Retrieve relevant durable BB memories or save verified knowledge useful to future threads. Memory is an agent skill from get-bb/bb. Retrieve relevant durable BB memories or save verified knowledge useful to future threads.

How do I install Memory in Claude Code?

Run `npx skills add get-bb/bb --skill memory -a claude-code`. Or copy the skill folder (plugins/memory/skills/memory in get-bb/bb) into .claude/skills/memory in your project. Claude Code loads it when a task matches its description.

How do I install Memory in Codex?

Run `npx skills add get-bb/bb --skill memory -a codex`. Or copy the skill folder (plugins/memory/skills/memory in get-bb/bb) into .agents/skills/memory in your project. Codex loads it when a task matches its description.

Can I use Memory in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add get-bb/bb --skill memory -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/memory, .gemini/skills/memory, .github/skills/memory and .opencode/skills/memory in your project.

What does Memory need to run?

SKILL.md names no scripts, command-line tools or credentials: Memory is instructions for the agent only.

Does Memory access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Memory safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Memory use?

Memory is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Memory use?

About 981 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Memory?

Skills that share tags, products or a category with Memory: Memori Long-Term Memory (MemoriLabs/Memori, 17k stars), Memori Long-Term Memory (MemoriLabs/Memori, 17k stars), Memory (yc-software/qm, 15k stars) and Memory Context (vectorize-io/hindsight, 46k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Memory?

get-bb (a GitHub organization) maintains it in get-bb/bb, which has 4,155 GitHub stars. The repository holds 33 skills in this directory. The repository was last updated on October 7, 2026.

Source: get-bb/bb on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.