PROJECT MEMORY
The next session.
The knowledge
you already have.
Keep conventions, research, and development notes in your project. Give your coding agent a source to work from.
Local Markdown · On-demand recall · Shared across agents
# In your agent, save a confirmed decision
Update the existing callback spec with the
idempotency rule. Use mini-trellis-remember
to record a link to the topic.# Find the source in a new session $ mini-trellis mem recall "callback idempotency" [doc] .trellis/spec/backend/callbacks.md Every callback carries an idempotency key… ref: <ref-from-recall>
# Expand the source when you need more $ mini-trellis mem read "<ref-from-recall>" Apply the current rule, verify the change, and update the same note.
Callback idempotency
Every callback carries an idempotency key. Repeated delivery returns the first result.
01 / CONTINUITY
Keep the parts
worth using again.
Code changes. Decisions change with it. Keep the current convention and the reasoning behind it available for the next change.
- 01
Record
Update the existing topic. Link this change and its verification from a journal.
- 02
Recall
Search documents and supported local conversations. Start with an excerpt.
- 03
Revise
Use the current rule. Update the source when the decision changes.
02 / YOUR REPOSITORY
Your documents.
In their own place.
Keep maintaining your README, docs, and project conventions. Markdown is editable, reviewable, and ready to share through Git.
See how it works →├── README.md ├── docs/ └── .trellis/ ├── spec/ conventions ├── research/ research & sources └── workspace/ session journals
03 / GET STARTED
Start with one decision worth keeping.
Install, record, and find it in a new session.
Get started →npm install -g mini-trellis
mini-trellis init -u your-name --claude
mini-trellis doctorNode.js ≥ 18.17 · Python ≥ 3.9 · Git
Continue in the agent you use
- Claude Code
- Codex
- Cursor
- OpenCode
- Pi
- OMP
- Kiro
- DeepSeek Harness
- CodeBuddy
- ZCode
From first use to everyday work
All documentation →Can I use my existing README and AGENTS.md?
Yes. Keep maintaining the documents where they belong. mini-trellis adds retrieval and helps the agent update topics and record useful conclusions.
Should I save every conversation?
Save decisions, research, and fixes that will help a later change. Use session-insight to organize selected historical conversations into project documents.
Which local conversations can I search?
v0.3.8 reads native Claude Code, Codex, OpenCode V1, and Pi history. Other supported agents can use project documents or organize a supplied text export.
What is preserved when migrating from Trellis?
Migration preserves spec, research, and workspace, and organizes old task material under research. Preview the plan and back up custom configuration first. The migration guide explains file handling.
Measurements & methods
Explore task duration, processed tokens, and injected-character measurements for the tested versions.