Phone owns state
The Twig root on disk is law. SQLite is an index you can throw away and rebuild.
Android · open source · your keys
Agents that live on your phone.
Twig keeps what matters on the device — agents, files, memory, conversations. Models run through providers you choose. A laptop may lend compute over USB; it never takes ownership.
On disk
twig/
agents/<id>/ private home
workspaces/ shared by grant
blobs/ content-addressed
db/twig.db rebuild anytimeHow it is put together
A few rules, held carefully. Everything else is detail.
Agents stay isolated
Each has a private home. Shared folders open only through grants that expire.
Writes are careful
Intent is journaled first, then the file changes. Crashes leave something honest.
Companion never owns
The laptop may run tools and scripts. Durable data stays on the phone.
What you get
The product, without the brochure fog.
A
Many agents
Name, personality, voice, and a home folder no other agent can open.
Learn more →WReal workspaces
Folders and files on disk, indexed for recall — not a rented vault.
Learn more →MMemory as files
Fast local recall. Deeper search when the embedder can join in time.
Learn more →DDreams
Background consolidation in small units. Cheaper model by default. Optional.
Learn more →CLaptop companion
USB for extra power. Same agents. No moving house.
Learn more →SSecurity model
Keys on device, sandboxed paths, a clear phone–companion boundary.
Learn more →Software you run — not a hosted brain you rent. Bring a key when you want conversation. Keep the archive either way.
Bhalala Corpv0.1.0MIT
Distribution
Get it on the device
Android only. You need a real development build with sqlite-vec — Expo Go is not enough. Prefer a tagged release when we publish one; until then, build from source.