FAQ
Frequently asked questions
Short answers to the questions people ask first.
Which AI coding tools does Workloom render for?
Claude Code and Codex today. Gemini, GitHub Copilot and Cursor have provider capabilities and fixtures defined, and their renderers are planned.
Will Workloom overwrite files I wrote myself?
No. Workloom only writes files it rendered and tracks. Any other file is user_owned and is never touched, and a Workloom-owned file you edited is reported as owned_locally_modified instead of being overwritten.
Can a package put a hook or an MCP server on my machine without asking?
No. Hooks, MCP server configs and tool permission grants have trust classes that need explicit approval before they are written. In a home workspace you acknowledge them with --yes, and without it the CLI stops with exit code 5.
How do I fail CI on drift?
Run `wl sync --ci` in the pipeline with an API token for a service account. It exits non-zero when rendered files have drifted from the desired state.
What does telemetry collect, and how do I turn it off?
Operational metadata such as the command, provider, result and duration. Fields that could carry prompts, code, file contents, paths, credentials, usernames or emails are rejected by the event schema. The CLI sends telemetry to the registry API it is configured for and it is on by default; `wl telemetry opt-out` or WORKLOOM_TELEMETRY=off turns it off.
Does AI review decide whether a package is published?
No. The deterministic content scan gates promotion. AI findings are advisory: they never gate, approve or change a trust class, and AI analysis runs only if your organization opts in.
How do I install the CLI?
With the installer script from the public workloom-releases repository, which downloads a prebuilt wl binary for macOS, Linux or Windows and checks its checksum. The CLI is not on npm or Homebrew, and the current published build is a test release.
Is there a desktop app?
Yes, built with Tauri. It wraps a bundled local API sidecar and shows status, diffs and drift for your local workspaces. The release pipeline builds a macOS app for Apple silicon; Windows and Linux builds are turned off, and the only published build is an early test release.
Are the plans real?
No. Workloom has no billing yet. The plans page shows sample names and prices only, and no payment is taken on this site.
Still stuck? Contact us.