dreamd: Instructions file for Codex

AGENTS.md

dreamd AGENTS.md is an instructions file for Codex, OpenCode from botzrDev/dreamd. It costs 41,787 tokens per session, scanned A, original, Apache-2.0.

Repository instructions for dreamd, a local memory system that lets different AI coding agents share learnings through files in a project folder.

In plain words
What is it for?
Use them when modifying dreamd's Rust core, command-line program, shared protocols, or Node.js package.
Why use it?
They explain what the project does, where its main parts are, and how to build and test it consistently.

Instructions file for CodexOpenCode

Written for Codex and OpenCode: the file is AGENTS.md. Also seen: reads .claude/ paths; mentions Claude Code; mentions AGENTS.md.

This is botzrDev/dreamd's own configuration. It tells Codex and OpenCode how to work on dreamd itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything dreamd configures →

Reuse

Borrowing it

Nothing to install: this file belongs to botzrDev/dreamd. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/botzrDev/dreamd/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/botzrDev/dreamd

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for dreamd AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/botzrdev/dreamd/agents-md/github.svg)](https://agentmods.dev/instructions/botzrdev/dreamd/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/botzrdev/dreamd/agents-md"><img src="https://agentmods.dev/badge/instructions/botzrdev/dreamd/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for dreamd AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/botzrdev/dreamd/agents-md"><img src="https://agentmods.dev/badge/instructions/botzrdev/dreamd/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 41,787 This file is loaded in full into every session.
When invoked 41,787 The same file — it is already loaded in full.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.41787 $0.41787
Opus 5.5 $0.16715 $0.16715
Sonnet 5.5 $0.08357 $0.08357
Haiku 4.5 $0.04179 $0.04179

Measured today against content hash 02c8bdae7eb5, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

dreamd AGENTS.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- Copy curl shape from `docs/http-api.md` `POST /api/v1/learn`; set reserved `source_harness` (e.g. `"aider"`).
AGENTS.md · 1,149 lines

How it starts

The opening of the file, as written. The whole thing — 1,149 lines — stays where its author put it; the contents beside it link to each section on GitHub.

AGENTS.md — dreamd

This file is read by Claude Code, Cursor, Cline, Codex, and other MCP-aware coding agents when working in this repository. It describes what this project builds, how to navigate and work in it, and the conventions that govern the codebase.


What this repo builds

dreamd is a local-first, single-binary memory layer for AI coding agents. Claude Code, Cursor, Cline, and other MCP-aware harnesses read and write to a shared .agent/ folder via MCP. What one agent learns, the next already knows. The file system is the source of truth — plain JSONL and Markdown you can cat, grep, git diff, and hand-edit.

The one job dreamd is hired for: memory continuity across tools. Not a second brain, not an ambient capture product, not a Python framework SDK.

Where it fits (2026-09-26). dreamd is the Linux-hosted proof of one pillar of dreamOS, the first computer you can hand your keys to, whose kernel is momo (charter: momo docs/rfc/RFC-009, amended by RFC-011, accepted 2026-09-26, Linear BZR-1075; local docs issue BZR-1077): memory as plain files a person owns, with provenance — the Memory, in the product's words. RFC-011 also names the rule the ledger grows toward — every effect traceable to the data that caused it; no datum causes an effect above its own trust label — as a design that needs its own spec before any code. It changes nothing shipped: no trust label exists, source_harness is caller-asserted, docs/provenance.md is format only (BZR-154) and records derivation, not trust. Constraints that stand: do not claim momo MemoryRegion objects (the BZR-827 rule below); do not document a trust label, taint, or "the Memory" as if it shipped; the momo repo is private, and while the product name dreamOS and its one-sentence destination may appear in this repository's docs as a pointer (ruled 2026-09-26 on BZR-1075, RFC-011 A0), announcing, previewing or marketing the product before its v1 stays forbidden — a pointer, never a launch.

Read the full file on GitHub · 1,149 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed · +141 lines · +4,288 tokens per session 02c8bdae7eb5
  2. 2d ago Changed · +44 lines · +2,074 tokens per session 3225ec32d406
  3. 3d ago Changed · +74 lines · +2,274 tokens per session 674011cd5a59
  4. 25d ago Changed · +222 tokens per session 0aa0a10dc062
  5. 27d ago Changed · +65 lines · +4,567 tokens per session 3b93c728db9e
  6. 28d ago Changed · +21 lines · +1,571 tokens per session 3160c46d2efd
  7. 1mo ago Changed · +18 lines · +1,086 tokens per session c677f03c15c8
  8. 1mo ago Changed · +105 lines · +3,822 tokens per session 9371420a593b
  9. 1mo ago Changed · +42 lines · +1,746 tokens per session 4cdc8f1ceb28
  10. 1mo ago First seen · 639 lines · 20,137 tokens per session scan A b84a43eaccbe

Subscribe to this mod's changes

dreamd AGENTS.md is an instructions file published in the GitHub repository botzrDev/dreamd (6 stars, last pushed yesterday), licensed Apache-2.0. It adds 41,787 tokens to every session, about $0.1671 per session on Opus 5.5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories