/install codon
Codon
Codon gives every memory an address. You navigate to it — you don't search for it.
Setup
If MEMORY/ does not exist in this workspace, run it once:
bash {baseDir}/init.sh
How to store
- Choose the right category from the taxonomy below
- Assign the next available ID in that category (check
XX.00-index.md) - Write to
MEMORY/\x3Carea>/\x3CXX.YY-description>.md - Add the ID to the category's index file
Example: new client contact → MEMORY/10-19-People/10.01-acme-jane-smith.md
How to recall
Navigate by ID prefix — don't search, locate:
- "Who are my contacts?" → read files in
MEMORY/10-19-People/ - "What projects are active?" → read files in
MEMORY/20-29-Projects/ - "Find the Acme notes" → look for
10-19-People/10.XX-acme-*
Default taxonomy
| Area | Name | Examples |
|---|---|---|
| 10-19 | People | Contacts, clients, team members |
| 20-29 | Projects | Active and past work |
| 30-39 | Resources | Tools, docs, links, references |
| 40-49 | Work | Tasks, decisions, meeting notes |
Rules
- Existing
memory.mdis preserved. UseMEMORY/for all new entries. - If something fits two categories, prefer the more specific one. A person who is also a project contact goes in 10-19 People, not 20-29.
- Index files (
XX.00-index.md) track which IDs are taken. Always update them. - IDs are never reused, even after deletion.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install codon - After installation, invoke the skill by name or use
/codon - Provide required inputs per the skill's parameter spec and get structured output
What is Codon?
Organize agent memory as a navigable filesystem. Every piece of information gets a numbered address (10.03-client-name.md) — no search required. Zero depende... It is an AI Agent Skill for Claude Code / OpenClaw, with 138 downloads so far.
How do I install Codon?
Run "/install codon" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Codon free?
Yes, Codon is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Codon support?
Codon is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Codon?
It is built and maintained by pauldub (@pauldub); the current version is v1.0.0.