🚧 Expanding soon — full Local SQLite documentation is in progress.
What is the local brain?
When you run bossmode init, the CLI seeds a local SQLite database at ~/.bossmode/brain.db. This database stores:
- Your standing orders
- Buyer profiles and voice calibration
- Directive history and audit feed
- Agent execution logs
- Local signal cache
- Guardian state
The local brain is the single source of truth for local-mode operation. In cloud-connected mode, it syncs bidirectionally with your Convex instance.
Database location
The directory also contains:
Schema overview
The local brain mirrors the Convex schema. Key tables:
Direct SQLite access
For power users who want to query directly:
Backup and restore
Sync to cloud
When you add your operator token, the local brain syncs to Convex automatically:
Sync is bidirectional. Local changes propagate to cloud. Cloud changes (from other devices or the web app) propagate locally.
SQLite to Convex
The Convex schema in convex/schema.ts mirrors the SQLite structure. If you fork BossMode and modify the schema, update both to keep sync working.
