WfOS (Workflows Operating System) is a local-first control layer for a developer machine. It does not replace your OS, shell, or package managers — it organizes them, routes to them, and exposes their meaning through a consistent local interface. It is modular and non-disruptive: adopt one package, keep your own environment, and grow into the rest when it earns its place.
Full docs: docs/. Start with architecture.
Archetypes are stable roles; products are swappable implementations — see
architecture § archetypes.
Experienced-dev path (Rust + this workspace root):
curl -fsSL https://moonrepo.dev/install/proto.sh | bash # once, if needed
proto install # .prototools pins (moon + rust)
moon run wfos:setup
moon run panoply:doctor
moon run ontarch:sync
cargo build -p takogami
cargo run -p takogami -- doctor
cargo run -p takogami -- graph
cargo run -p takogami -- bin reportmoon run takogami:build / takogami:test work the same. This is a
moon + proto monorepo
(.prototools, .moon/). Details:
docs/setup.md · docs/monorepo.md.
| Package | Archetype | Product | CLI | Role | Status |
|---|---|---|---|---|---|
panoply/ |
native-toolchain |
Panoply 🧰 | panoply (later takogami native) |
Local Unix/Rust tool execution | implemented |
ontarch/ |
metadata-plane |
Ontarch 📐 | build tasks (ontarch:*; later takogami meta) |
Descriptors, registry, schemas, policies | implemented |
takogami/ |
runtime-controller |
Takogami 🐙 | takogami |
Discovery, routing, policy, execute, graph/bin, command records | implemented |
polytope/ |
package-translator |
Polytope 📦 | takogami package |
Intent → packages and artifacts | planned |
wisp/ |
portable-component-runtime |
Wisp 🫧 | takogami portable (planned) |
WASM/WASI sandboxed components | planned |
| App | Role | Status |
|---|---|---|
apps/docs/ |
Render workspace docs for humans (Zola) | planned |
apps/web/ |
Single-page marketing site (Zola) | planned |
Index and guides: docs/README.md. Agents: AGENTS.md.
Standalone git repository (main), local-first. Generated host output (metadata-plane
registry, target/, .moon/cache) is gitignored; sources, contracts, and docs stay tracked.