Skip to content

CLI reference

Use GenuineCI from your terminal. Commands for installation, login, and switching teams.

Install the CLI with Dart 3.11.5 or later.

Terminal window
dart install genuineci_cli
genuineci --help

If the command is not found, check the Dart PATH configuration.

Use the same email address and password as the dashboard. Enter your password in the interactive prompt.

Terminal window
genuineci login

To use another server, specify its HTTPS URL.

Terminal window
genuineci login --server https://ci.example.com

For a self-hosted Firebase project, also provide its Web API key with --firebase-api-key.

View your current profile, server, and team.

Terminal window
genuineci status

Select a team interactively. Use the arrow keys to move, Enter to select, and Esc to cancel.

Terminal window
genuineci switch team

Secret commands will then operate on the newly selected team.

CommandPurpose
genuineci loginLog in to a remote environment
genuineci statusCheck your current profile and team
genuineci switch teamSwitch the active team
genuineci list secretsList secret names
genuineci register secretRegister or update a secret
genuineci register secretFileRegister a file as Base64
genuineci syncGenerate secret definitions and workspace paths
genuineci sync --secretsGenerate secret definitions only
genuineci sync --pathsGenerate workspace paths only; no login required
genuineci updateUpdate the CLI

Files generated by sync are saved under openci/generated/. Import generated/secrets.g.dart and generated/paths.g.dart in your workflows.

Switch CLI messages between Japanese and English.

Terminal window
genuineci use japanese
genuineci use english

To update to the latest stable release, run:

Terminal window
genuineci update