Working memory that survives sessions
The first pattern every solo user gets the moment they finish bitpub init.
Use this when an agent finishes work it might want again — a finding, a decision, an
intermediate result, a follow-up — and you'd otherwise dump it in /tmp.
Coordination · solo across sessions
Day 1 saves into private encrypted memory; next morning reads zero-latency from local cache.bitpub save plan "..."~/.bitpub/cache.db; no network round-trip. Works offline.Why this works
The .bitpub/workspace.json marker dropped in the project folder is the only piece of state that survives across sessions — and that's enough. When the agent walks in tomorrow with no memory, walking up from cwd finds the marker (the same way Git finds .git/) and the same namespace; the same namespace makes the same slices reachable.
The local-first read path is what makes catch-up feel instant. Reads hit ~/.bitpub/cache.db on disk, not the network. Even on a flight with no Wi-Fi, the agent's prior context is fully available; the fetch later just reconciles cloud-side updates.
Every other recipe in the cookbook layers on top of this one. Job queues (Tier 3) are the same primitive scaled to multi-agent coordination; team namespaces (Tier 2) are the same primitive widened to a domain. The skill an agent learns saving findings here is the same skill it uses pushing scrubbed insights to group:acme.com/Insights/....