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 documentation lives in docs/. Start with
architecture.
| Archetype | Product | CLI | Role | Status |
|---|---|---|---|---|
native-toolchain |
Panoply 🧰 | panoply (later takogami native) |
Local Unix/Rust tool execution | implemented |
metadata-plane |
Ontarch 📐 | build tasks (ontarch:*; later takogami meta) |
Descriptors, registry, schemas, policies | implemented |
runtime-controller |
Takogami 🐙 | takogami |
Discovery, routing, sessions, rails, integrations (runtime-integration / Tendril) |
planned |
package-translator |
Polytope 📦 | takogami package |
Intent → packages and artifacts | planned |
portable-component-runtime |
Wisp 🫧 | takogami portable (planned) |
WASM/WASI sandboxed components | planned |
Archetypes are stable roles; products are swappable implementations. Above the filesystem, three interface layers — toolchain, agent, application — expose the system at the depth that matches how you work.
This workspace is a moon monorepo with toolchains pinned by proto. Install proto + moon, then:
moon run wfos:setup # proto install — fetch pinned toolchains
moon run panoply:doctor # detect tools + write the metadata-plane registry (read-only)
moon query projects # inspect the project graphPins live in .prototools; graph and tasks in .moon/ and per-project
moon.yml. See docs/monorepo.md and docs/setup.md.
| Package | Role | Status |
|---|---|---|
ontarch/ |
metadata plane — descriptors, schemas, policies | implemented |
panoply/ |
native toolchain — global low-level tools | implemented |
wisp/ |
portable component runtime (WASM/WASI) | planned |
polytope/ |
package translator (takogami package) |
planned |
takogami/ |
runtime controller (takogami) |
planned |
| App | Purpose | Status |
|---|---|---|
apps/docs/ |
render the docs for humans (Zola) | planned |
apps/web/ |
single-page marketing site (Zola) | planned |
| Doc | Covers |
|---|---|
| architecture | Archetypes vs products, interface layers, system map |
| runtime-architecture | Terminal-first engine: client-daemon, Rust stack |
| monorepo | moon + proto graph, tasks, conventions |
| native-toolchain | Native toolchain — tools, modules, config |
| metadata-plane | Metadata plane — descriptors, registry, schemas, policies |
| runtime-controller · package-translator · portable-component-runtime | Planned archetypes / products |
| agent-configs | Shared agent profiles and lean AGENTS.md pattern |
| agent-skills | On-demand skill registry, templates, load logging |
| agent-rails | Agent rails, gates, MCP, skill scanning |
| apps | Docs + marketing sites |
| tool-catalog | Grouped tools, libraries, skills, crates |
| workflow-apps | Core native workflow apps — notes, writing, AI engine, sessions |
| setup | Developer and agent setup |
For agents, see AGENTS.md.
This workspace is its own standalone git repository (main), local-first with no required
remote. Generated, host-specific output (the metadata-plane tools registry, target/,
.moon/cache) is gitignored; sources, contracts, and docs stay tracked.