Quickly save a small fact, reminder, or user preference into Basic Memory from Codex without turning it into a full decision or checkpoint.

AGPL-3.0Auto-check passed

Install Bm Remember

skills CLI
$ npx skills add basicmachines-co/basic-memory --skill bm-remember -a claude-code

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

GitHub CLI
$ gh skill install basicmachines-co/basic-memory bm-remember --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/basicmachines-co/basic-memory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/codex/skills/bm-remember .claude/skills/bm-remember && 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
bm-remember
GitHub stars
4.1k
Token cost
~327 tokens
SKILL.md length
153 words
Files
3 (incl. assets)
Skills in repo
49
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Quickly save a small fact, reminder, or user preference into Basic Memory from Codex without turning it into a full decision or checkpoint.

  • Works in 4 steps: Read ~/.codex/basic-memory.json, then… → Identify the exact text to save. If the… → Write with write_note → …
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Bm Remember is an agent skill from basicmachines-co/basic-memory. Quickly save a small fact, reminder, or user preference into Basic Memory from Codex without turning it into a full decision or checkpoint.

Its SKILL.md is about 330 tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including assets (for example `agents/openai.yaml`).

The repository describes itself as: AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord: https://discord.gg/tyvKNccgqN. The licence is AGPL-3.0.

Example prompts

  • “/bm-remember”

Workflow steps

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

  1. Read ~/.codex/basic-memory.json, then the nearest project
  2. Identify the exact text to save. If the user supplied text, preserve their
  3. Write with write_note
  4. Confirm in one line with the permalink.

What it can do on your machine

Read from SKILL.md and the folder at commit 6982cfc. 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.

    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

Bm Remember loads about 327 tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 153 words of instructions outside code blocks.

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

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 basicmachines-co/basic-memory at commit 6982cfc, republished under its AGPL-3.0 licence (© basicmachines-co). 153 words, ~327 tokens.

Download SKILL.mdSave it as .claude/skills/bm-remember/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
bm-remember
description
Quickly save a small fact, reminder, or user preference into Basic Memory from Codex without turning it into a full decision or checkpoint.

Remember

Use this for lightweight capture: "remember that", "save this", "note this", or a small fact that should survive the current thread.

Steps

  1. Read ~/.codex/basic-memory.json, then the nearest project .codex/basic-memory.json; project keys override user keys:

    • primaryProject, default omitted
    • rememberFolder, default codex/remember

    Apply the bm-writing skill before drafting the note. Match its depth to this lightweight capture; do not pad a small fact into an essay.

  2. Identify the exact text to save. If the user supplied text, preserve their wording. If the user said "remember that" and the referent is unclear, ask one short question.

  3. Write with write_note:

    • title: first line trimmed to 80 characters, or a short descriptive title
    • directory: rememberFolder
    • content: the text to remember
    • tags: ["codex", "manual-capture"]
    • route to primaryProject if configured
  4. Confirm in one line with the permalink.

Do not use this for decisions with alternatives or for work handoffs. Use bm-decide or bm-checkpoint for those.

© basicmachines-co, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (assets) in plugins/codex/skills/bm-remember of basicmachines-co/basic-memory.

  • SKILL.md
  • agents/openai.yaml
  • assets/icon.svg

Open the folder on GitHubat commit 6982cfc

Compare with similar skills

Bm Remember 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.

Bm Remember compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Bm Remember this skillbasicmachines-co/basic-memory4.1k—~327Automated safety check: PassAGPL-3.0
Mem0 Remembermem0ai/mem067k—~410Automated safety check: PassApache-2.0
Mem0 Remember Commandmem0ai/mem067k—~560Automated safety check: PassApache-2.0
Rememberalirezarezvani/claude-skills28k1 repos~784Automated safety check: PassMIT
Remembergithub/awesome-copilot40k1 repos~1.6kAutomated safety check: PassMIT
Save to Long-Term Memoryrohitg00/agentmemory29k—~600Automated safety check: PassApache-2.0

Similar skills

  • Mem0 Remember

    mem0ai/mem0

    Stores a fact, preference or lesson verbatim in Mem0 through /mem0-remember and files it under a category such as preferences, decisions or goals.

    67k GitHub stars~410 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Saves a fact, decision or preference the user states into mem0 as written, labeled with a memory type such as decision, convention or user_preference.

    67k GitHub stars~560 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Remember

    alirezarezvani/claude-skills

    Explicitly save important knowledge to auto-memory with timestamp and context.

    28k GitHub starsUsed in 1 repo~784 tokens
    Agent WorkflowsAuto-check passed
  • Remember

    github/awesome-copilot

    Official

    Transforms lessons learned into domain-organized memory instructions (global or workspace).

    40k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Save to Long-Term Memory

    rohitg00/agentmemory

    Saves an insight, decision or fact to agentmemory with specific concept tags and file paths, so a later recall can find it in a future session.

    29k GitHub stars~600 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Remember

    HKUDS/OpenSpace

    Review auto-memory entries and propose promotions to OPENSPACE.md, OPENSPACE.local.md, or retained auto-memory topics; detect duplicates, stale facts, conflicts, and ambiguous entries before making…

    7.7k GitHub stars~847 tokensUpdated 1 mo ago
    Auto-check passed

More from basicmachines-co/basic-memory

All 49 skills in this repo
  • cmux Settings Editor

    basicmachines-co/basic-memory

    Views, sets, unsets and validates cmux settings in ~/.config/cmux/cmux.json with a helper script that checks keys against the schema.

    4.1k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • cmux Window and Pane Control

    basicmachines-co/basic-memory

    End-user control of cmux topology and routing (windows, workspaces, panes/surfaces, focus, moves, reorder, identify, trigger flash). Use when automation needs…

    4.1k GitHub starsUsed in 2 repos~842 tokens
    Auto-check passed
  • Cmux Markdown Viewer Panel

    basicmachines-co/basic-memory

    Opens markdown files in a formatted cmux panel beside the terminal that re-renders on every change, handy for plans and task lists.

    4.1k GitHub starsUsed in 2 repos~527 tokens
    Auto-check passed
  • cmux Workspace Scoping

    basicmachines-co/basic-memory

    Keeps agent actions scoped to the cmux workspace and terminal that invoked it, and lays out pane and surface commands that avoid disrupting the user's own focus.

    4.1k GitHub starsUsed in 2 repos~1.7k tokens
    Auto-check passed
  • Basic Memory Repo Images

    basicmachines-co/basic-memory

    Produces PR, changelog and two-week retro images for the Basic Memory repository from evidence in PR bodies, saved to fixed paths under docs/assets/infographics.

    4.1k GitHub stars~2.7k tokensUpdated today
    Auto-check passed
  • Logfire Instrumentation

    basicmachines-co/basic-memory

    Adds Pydantic Logfire tracing, logging and metrics to Python, JavaScript or TypeScript and Rust projects, with the correct setup order and library extras.

    4.1k GitHub stars~2.3k tokensUpdated today
    Auto-check passed

Questions about Bm Remember

What does Bm Remember do?

Quickly save a small fact, reminder, or user preference into Basic Memory from Codex without turning it into a full decision or checkpoint. Bm Remember is an agent skill from basicmachines-co/basic-memory. Quickly save a small fact, reminder, or user preference into Basic Memory from Codex without turning it into a full decision or checkpoint.

How do I install Bm Remember in Claude Code?

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

How do I install Bm Remember in Codex?

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

Can I use Bm Remember 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 basicmachines-co/basic-memory --skill bm-remember -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/bm-remember, .gemini/skills/bm-remember, .github/skills/bm-remember and .opencode/skills/bm-remember in your project.

What does Bm Remember need to run?

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

Does Bm Remember 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 Bm Remember 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 Bm Remember use?

Bm Remember is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Bm Remember use?

About 327 tokens (SKILL.md is roughly 1.3k 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 Bm Remember?

Skills that share tags, products or a category with Bm Remember: Mem0 Remember (mem0ai/mem0, 67k stars), Mem0 Remember Command (mem0ai/mem0, 67k stars), Remember (alirezarezvani/claude-skills, 28k stars) and Remember (github/awesome-copilot, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Bm Remember?

basicmachines-co (a GitHub organization) maintains it in basicmachines-co/basic-memory, which has 4,107 GitHub stars. The repository holds 49 skills in this directory. The repository was last updated on October 7, 2026.

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