
Substrate
If you're building a founder copilot or any AI agent that needs to remember things across sessions, this gives Claude direct access to Butterbase's per-user memory backend. It's got four stores: entities (people, companies), business state (MRR, headcount), institutional memory (decisions, learnings), and an append-only action ledger. Every write goes through a propose, policy check, execute loop so agents can't quietly trash your data. The anti-patterns section is worth reading closely: the action ledger is truly append-only, update_entity replaces the whole attrs object instead of patching, and you need canonical_keys or primary_email for dedup to work. Not for plain CRUD apps, but if you want a single source of truth that an agent operates on, this is the primitive.
- GitHub stars
- 532
- last updated
- Jun 11, 2026
Install
$ npx -y skills add butterbase-ai/butterbase-skills --skill substrate --agent claude-codeInstalls into .claude/skills of the current project.
Files
Butterbase Substrate
Substrate is an optional, per-user add-on backend. One substrate per Butterbase account, lazily provisioned on first use, queryable from local Claude Code (via MCP), from any opted-in Butterbase app (via ctx.substrate inside functions), and from external systems (via HTTP).
Four stores
| Store | What lives there | Tools |
|---|---|---|
| Entities | People, companies, projects you transact with | get_entity, find_entities |
| Business state | Numeric facts that change over time (MRR, headcount) | find_entities with type filter |
| Institutional memory | Decisions, commitments, learnings | search_memory |
| Action ledger | Append-only log of every proposed/executed action | list_outbox, propose_action history |
The propose → policy → execute → log loop
Every write goes through this loop. Agents NEVER touch the substrate database directly.
Sponsors
Details
- Repository
- github.com/butterbase-ai/butterbase-skills
- Category
- AI & Agent Building
- License
- MIT
- First seen
- Jun 11, 2026