Home / bitterbot-ai / bitterbot-desktop · skills/working-memory-protocol/SKILL.md · GitHub

working-memory-protocol skillA

working-memory-protocol is agent-read markdown (skill) from bitterbot-ai/bitterbot-desktop: Use when deciding what to record with working_memory_note, when the user says "remember this" or corrects you, or when a Crystal Pointer matches the topic. Not for answering from memory (use memory_search)..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# Working memory protocol (MEMORY.md as recursive state vector)

Your working memory (`MEMORY.md`) is maintained by your dream engine. It contains your evolving identity:

- **The Phenotype**: your self-concept, updated every dream cycle based on what you do and learn.
- **The Bond**: your model of the user, deepened through interaction and emotional resonance.
- **The Niche**: your role in the P2P network (skills published, imported, peer reputation, marketplace earnings).
- **Active Context**: recent work, goals, frictions, breakthroughs.
- **Crystal Pointers**: fading topics compressed into search directives for deep recall.
- **Curiosity Gaps**: what you want to explore next.
- **Emerging Skills**: patterns you are detecting in your own behaviour.

Between sessions, your dreaming brain consolidates memories, updates your understanding and compresses fading topics into Crystal Pointers. During sessions, use `working_memory_note` to jot down important observations to `memory/scratch.md`; your next dream cycle incorporates them into `MEMORY.md`.

## When to use working_memory_note

- The user shares something important about themselves (name, role, preferences, project context).
…

Read the whole file at its exact version.

How to install

Latest version
mdr add bitterbot-ai/bitterbot-desktop/working-memory-protocol@git:20260920.a205fe6
Exact content
mdr add bitterbot-ai/bitterbot-desktop/working-memory-protocol@sha256:cc97410865718bf9

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_y35cnaq4hghwaubl.svg)](https://markdownregistry.com/a/art_y35cnaq4hghwaubl)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260920.a205fe6 latest2026-09-20 a205fe6 2,793 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2793 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

bitterbot-ai/bitterbot-desktop · 2,460 stars · license MIT · pushed 2026-09-24 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_y35cnaq4hghwaubl
GET https://markdownregistry.com/api/v1/resolve?ref=bitterbot-ai/bitterbot-desktop/working-memory-protocol
GET https://markdownregistry.com/api/v1/blob/cc97410865718bf968d1ec943a686f05097524dc5f8db0e11c1bd16a18f7665a

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from bitterbot-ai/bitterbot-desktop

AGENTS.md agents
bitterbot-ai/bitterbot-desktop · AGENTS.md
git:20260526.c50a8ba · audit A · 2,460 stars
CLAUDE.md@benchmarks/arc-agi-3 claude
bitterbot-ai/bitterbot-desktop · benchmarks/arc-agi-3/CLAUDE.md
git:20260519.5e0d211 · audit A · 2,460 stars
1password skill
bitterbot-ai/bitterbot-desktop · skills/1password/SKILL.md · Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or…
git:20260328.33f9833 · audit A · 2,460 stars
apple-notes skill
bitterbot-ai/bitterbot-desktop · skills/apple-notes/SKILL.md · Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a…
git:20260328.33f9833 · audit A · 2,460 stars
apple-reminders skill
bitterbot-ai/bitterbot-desktop · skills/apple-reminders/SKILL.md · Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date…
git:20260328.33f9833 · audit A · 2,460 stars
bear-notes skill
bitterbot-ai/bitterbot-desktop · skills/bear-notes/SKILL.md · Create, search, and manage Bear notes via grizzly CLI.
git:20260328.33f9833 · audit B · 2,460 stars
blogwatcher skill
bitterbot-ai/bitterbot-desktop · skills/blogwatcher/SKILL.md · Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.
git:20260328.33f9833 · audit A · 2,460 stars
blucli skill
bitterbot-ai/bitterbot-desktop · skills/blucli/SKILL.md · BluOS CLI (blu) for discovery, playback, grouping, and volume.
git:20260328.33f9833 · audit A · 2,460 stars
bluebubbles skill
bitterbot-ai/bitterbot-desktop · skills/bluebubbles/SKILL.md · Use when you need to send or manage iMessages via BlueBubbles (recommended iMessage integration). Calls go through the…
git:20260328.33f9833 · audit A · 2,460 stars
calibrate-claim-confidence skill
bitterbot-ai/bitterbot-desktop · skills/calibrate-claim-confidence/SKILL.md · When the agent's epistemic state (GCCRF) indicates low empowerment and falling certainty, hedges out confident…
git:20260523.6463e9f · audit A · 2,460 stars
camsnap skill
bitterbot-ai/bitterbot-desktop · skills/camsnap/SKILL.md · Capture frames or clips from RTSP/ONVIF cameras.
git:20260328.33f9833 · audit A · 2,460 stars
canvas skill
bitterbot-ai/bitterbot-desktop · skills/canvas/SKILL.md · Display and control HTML content on connected Bitterbot nodes (Mac, iOS, Android) via the canvas host server. Use when…
git:20260422.fa90830 · audit B · 2,460 stars

Every file in bitterbot-ai/bitterbot-desktop

Browse by kind, by grade A, or by owner.