FAQ
Frequently asked questions
Short, exact answers. If yours is not here, ask us.
Which assistants does Workloom write config for?
Claude Code, Codex and GitHub Copilot. Gemini is early: its adapter plans GEMINI.md and .gemini/settings.json, with warnings.
Will Workloom overwrite a file I wrote by hand?
No. Sync changes or removes only files Workloom owns. Files with user or shared ownership are left alone, and committed projections need a local approval first.
What is the difference between `wl render --dry-run` and `wl sync --check`?
Render shows what would be written. The sync check compares what is on disk with the drift baseline from the last sync and exits non-zero on drift; it never writes.
Does the CLI send telemetry?
Yes, by default: after its main commands it posts one event with the command, result, duration, CI mode and hashed workspace and org IDs, to WORKLOOM_TELEMETRY_ENDPOINT (a local API address unless you set it). Set WORKLOOM_TELEMETRY_ENABLED=false to turn it off.
Do render and sync need the registry?
No. They read package content from a local package directory (--fixtures, default fixtures/). The registry commands (bind, pull, push, status, restore, profile) use the API when WORKLOOM_REGISTRY_URL is set.
How do I install it?
Only a test build is published: the install script in the releases repository installs wl on macOS (Apple silicon) and Linux; on Windows, download wl-windows-x64.exe. It is not on npm or Homebrew. You can also run it from source with pnpm.
Is there a desktop app?
Yes, a Tauri app that binds folders and runs status, diff, render, sync and restore. The test build has a notarized macOS app and unsigned Linux and Windows builds; the current release workflow builds macOS only.
Does advisory review send my packages to an AI provider?
Only if an org admin turns it on. Then the registry sends the package content being reviewed to Anthropic or OpenAI. Findings never block publishing.
Still stuck? Contact us.