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.
This README.md is the shared entrypoint for humans and automated workers. Read it first, then enter a package, app, or documentation namespace through its nearest maintained README.md.
Run commands from the workspace root unless the local README says otherwise. Native manifests remain authoritative; Ontarch describes meaning, routing, and policy but does not replace them. Automated-worker scope and rails remain in shared profiles, Ontarch policies, and the existing agent documentation rather than a parallel AGENTS.md hierarchy.
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. Automated-worker profiles and rails: agent configs · agent rails.
Standalone git repository (main), local-first. Generated host output (metadata-plane
registry, target/, .moon/cache) is gitignored; sources, contracts, and docs stay tracked.