Fabric handbook · Executor + Studio
Import and export setup
A setup ZIP carries reusable configuration. Each recipient still reviews local paths, signs into services, builds knowledge and imports agents separately.
◇
Reference
Choose the right file
| File | Open it where | What it does |
|---|---|---|
| Fabric Installer.zip | Finder → extract → installer app | Installs or upgrades Executor and Studio. It is not a setup bundle. |
| Setup bundle ZIP | Settings → General → Import setup bundle | Previews supported non-secret setup, shareable skills and source definitions. |
| Signed .forge-agent | Pipeline → Import agent | Imports a versioned agent package through trust and compatibility checks. |
| Google Desktop OAuth client JSON | Settings → Connectors → Google sign-in setup | Registers the client used for Google browser consent. It is not the user’s login or a setup profile. |
◇
Reference
Export from a working machine
- Review which workspace and Environment profile are active. Remove obsolete source definitions from the intended shared setup.
- Choose Settings → General → Setup and transfer → Export setup bundle.
- Share the resulting setup ZIP through your team’s approved channel, together with the intended agent package and repository prerequisites. The General Settings export excludes private knowledge content; do not assume it is a machine backup.
◇
Reference
Import on the receiving Mac
- Wait until no jobs are queued or running. Open Import setup bundle and select the setup ZIP.
- Read Settings to save as a draft, incoming files, existing-file conflicts and skipped entries. Preview is not yet an import.
- Choose Keep existing by default. Choose replacement only for the reviewed conflicts you intend to replace; supported replacement creates private backups and rolls back if applying files fails.
- Review the path suggestions. Check only fields that point to real folders on this Mac, and correct the values before proceeding. Repositories themselves are not copied.
- Confirm the previewed bundle. The import is bound to its preview digest; changed bytes require a new preview.
- Inspect the result. Select the imported Environment profile draft, review it, then click Apply. Resolve path validation errors and restart when prompted and idle.
- Reconnect credentials, check connectors, build the knowledge index, and import the signed agent package. Verify health before a first run.
◇
Reference
What transfers and what stays private
| Category | Behavior |
|---|---|
| Non-secret settings | Supported AI routing, preferences, source definitions, connector enablement and skill configuration become reviewable setup. |
| Paths | Only reviewed paths are included in the imported draft; another Mac’s locations do not activate automatically. |
| User playbooks | Shareable Markdown knowledge can transfer. Factory skills and executable authority are not overwritten by a setup ZIP. |
| Executable contracts | A transferred fabric_skill.json is treated as imported reference metadata, not activated executable authority. |
| Credentials | Tokens, passwords and Google user consent do not transfer. Sign in on the receiving Mac. |
| Private activity | Run history, private conversations, runtime memory and caches are excluded. |
| RAG index | Definitions are not embeddings or a ready index. Rebuild against sources this user can access. |
| Agents | Use signed .forge-agent packages and Executor admission independently. |
◇
Reference
Import problems
Invalid archive, unsafe path, duplicate file or digest mismatch: stop and obtain a fresh export; do not unzip arbitrary contents into the application. Existing files: keep your local version or review the replacement. Path rejected: select the actual local checkout. Settings imported but unchanged: apply the imported draft profile. Missing credentials: expected—configure your own access.