Current Status
There is no first-class Workspace Link command group in the current CLI implementation.
Workspace Link is currently managed in the macOS app, where the user can select a local Firebase repo, inspect configuration files, compare local and remote state, and review deploy targets before any write-like action. The CLI page documents the desired terminal boundary without claiming those commands are available today.
GUI-Only Coverage Today
Use the macOS Workspace Link module for:
- local Firebase workspace linking
firebase.jsonand.firebasercinspection- rules/index viewing
- local vs remote diffing
- guarded deploy workflows
Before a deploy or configuration review, confirm that the linked folder contains
the expected firebase.json, .firebaserc, rules files, indexes files, and
selected Firebase project alias. The GUI makes those details visible so users do
not accidentally compare or deploy from the wrong checkout.
For automation planning, separate read-only inspection from deploy behavior.
Future workspace status and workspace diff commands can be safe by default,
while deploy commands must require confirmation, show project/environment
labels, respect read-only and Pro gates, and send long-running work through the
task queue.
Future CLI Shape
Expected future commands:
workspace link --path .
workspace status
workspace diff --rules
workspace diff --indexes
workspace deploy --rules --confirm
workspace deploy --indexes --confirm
Source Anchors
Sources/FirestructCore/WorkspaceLinkRemoteService.swiftSources/FirestructCore/ProjectRegistry+WorkspaceServices.swift