Getting started
fbrcm is a terminal manager for Firebase Remote Config. Use the interactive TUI to explore and edit projects, or use the CLI for scripts, repeatable operations, and machine-readable output.
Install
Install with Homebrew:
brew tap yumauri/tap
brew install --cask fbrcmAlternatively, run the installer directly:
curl -sSfL https://raw.githubusercontent.com/yumauri/fbrcm/main/install.sh | shConnect an identity
Launch fbrcm without arguments:
fbrcmOn a new profile, guided setup offers three authentication methods:
- an OAuth Desktop app client;
- a service-account JSON key; or
- Google Cloud CLI Application Default Credentials.
The selected identity must be able to discover the projects you need and read their Remote Config templates. Write workflows additionally require permission to validate and publish templates.
Run the diagnostic whenever you need to check credentials, connectivity, permissions, or local storage:
fbrcm doctorInspect your first parameter
The TUI opens with the project list on the left and Remote Config data in the main workspace. Select a project, then choose a parameter to open its details. Press ? at any time to search the available actions and shortcuts.
The equivalent CLI workflow is:
# Discover accessible projects.
fbrcm projects list --update
# Inspect one parameter across production-like projects.
fbrcm get feature_enabled --project '^prod'Project filters support fuzzy, prefix, contains, and exact matching. Use an exact selector such as =my-project-id when a command must target one physical project.
Preview before writing
Remote Config publication replaces a complete template, so fbrcm makes review part of every write:
fbrcm update feature_enabled \
--project '=my-project-id' \
--type boolean \
--value true \
--dry-runUse --draft instead of --dry-run to save the change locally for later review. See Safe changes for the complete workflow.
Next steps
- Read the mental model before working across several projects or templates.
- Follow the TUI overview for interactive navigation.
- Open the CLI overview for command conventions and targeting.
- Use Agent workflows when calling fbrcm from an LLM, CI job, or other automation.