# Memory Comark

Write Basic Memory notes that render as charts, tables, boards, and live views with...

- Repository: https://github.com/basicmachines-co/basic-memory (4440 stars)
- Category: Writing
- License: AGPL-3.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add basicmachines-co/basic-memory --skill memory-comark -g -a claude-code -y`
Codex: `npx skills add basicmachines-co/basic-memory --skill memory-comark -g -a codex -y`
Cursor: `npx skills add basicmachines-co/basic-memory --skill memory-comark -g -a cursor -y`
Gemini CLI: `npx skills add basicmachines-co/basic-memory --skill memory-comark -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add basicmachines-co/basic-memory`

## Description

Write Basic Memory notes that render as charts, tables, boards, and live views with `::bm-*` Comark components. Use when a note reads better as a figure or board, or already has `::bm-*` directives.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Memory Comark

Basic Memory notes can carry small, safe components written as Comark block
directives (`::bm-bars{...}` … `::`). Basic Memory Cloud draws them in Notes, the
Wiki, and shared pages. Everywhere else (a local editor, GitHub, an agent's raw
read) the same Markdown still reads as an ordinary list, table, or paragraph, so
a component never hides content.

Use a component when its shape says more than a sentence or a list would. Keep
prose primary: one figure per idea, at most two per section, with a sentence
between them that says what the figure shows.

The full vocabulary, every prop, and every data grammar are in
[references/components.md](references/components.md). Read it before using a
component you have not used before.

## Project scope

If the project is unknown, discover it with `bm_project(command="list")`.
Pass a nonempty `project` on every note, folder, context and schema call, even
with one project or a qualified `memory://` URL. Use the chosen project's name,
`workspace/project`, or external ID; `<project>` below is a placeholder for it.
Recent activity also requires `project`. Search accepts `project` for one
project, `projects` for selected projects, or `all_projects=True` explicitly.
Discovery and bundled manuals need no project. Keep the same scope when following
returned paths, paginating, or recovering from a refusal.

## Pick a component

Most notes need only these. The reference has the rest (39 in total).

The rest: https://github.com/basicmachines-co/basic-memory/blob/HEAD/skills/memory-comark/SKILL.md