Packages & apps
What each folder is for. No mystery.
Apps
| Package | Job |
|---|---|
apps/native | Android app. Expo. React Native. HeroUI Native. Uniwind. |
apps/cli | Laptop companion TUI. Lends compute over USB. |
apps/fumadocs | Docs + marketing. twig.bhalala.org |
Packages
| Package | Job |
|---|---|
@twig/core | Domain: agents, workspaces, memory types, dreams, skills, paths, ids |
@twig/memory | FS + journal + index + recall (adapters in) |
@twig/harness | Models + tools (planned) |
@twig/link | USB protocol phone ↔ laptop (planned) |
@twig/env | Env schemas |
@twig/config | Shared TS config |
@twig/core + @twig/memory = heart of what exists now. Zod schemas. Pure logic. Phone
and companion share types without dragging Expo or Node into shared graph.
Tooling
- Bun workspaces + catalog
- Turborepo for dev / build / types / test
- TypeScript via
@twig/config
bun install
bun run check-types
bun run test