Product
The product
Workloom manages AI workflow assets the way a package manager manages code: versioned packages, pinned per workspace, rendered deterministically, with drift detection and trust gates on top.
Canonical packages
A canonical package is a versioned, immutable, organization-scoped bundle of assets: instructions, skills, agents, prompts, hooks, MCP server configs and provider configs. Provider files are always derived from it, never the reverse.
Package versions move from draft through review to approved, a deterministic content scan gates promotion, and channels point each package at its current version.
Workspaces and rendering
A workspace says which packages apply to one repository or home directory, for which providers. A provider adapter turns the assets into that provider’s native files, and the render plan lists every file with its content hash.
Claude Code and Codex renderers are implemented. Gemini, GitHub Copilot and Cursor have fixtures defined and are planned.
Trust and drift
Each asset has a trust class. Hooks, MCP servers and tool permission grants need explicit approval before they are written, so they never silently appear on a developer’s machine.
Workloom-owned files are tracked by hash. `wl sync --ci` fails a build when files on disk have drifted from the desired state, and files Workloom did not render are never touched.
Ways in
The registry API (Hono, OpenAPI 3.1) holds packages, workspaces and organization data. The dashboard is where members manage the registry, workspaces, home stacks, telemetry and administration. The `wl` CLI binds a directory to a workspace, pulls, syncs, pushes and reviews.
The desktop app (Tauri) wraps a bundled local API sidecar and shows the status, diffs and drift of your local workspaces, with pull, sync and restore.
At a glance
- Renderers implemented
- Claude Code, Codex
- Fixtures defined
- Gemini, GitHub Copilot, Cursor
- Trust classes
- passive_text, configuration, tool_permission, executable_hook, networked_mcp, telemetry_emitting
- Ownership states
- user_owned, owned_clean, owned_missing, owned_locally_modified, owned_conflict
- Roles
- org_admin, package_owner, workspace_admin, developer
- CLI binary
- wl
Stop copy-pasting AI config between repos
Put your instructions, skills and hooks in one registry, pin them per repository, and let CI tell you when anything drifts.