​
CLI Overview

fl-repos is the supported Python command-line interface for the open-source, local-first Community Edition. It provides extraction, enrichment, graph operations, fleet work, reports, improvement workflows, and tenant-cloud publishing. It is a Click command group exposed by the fl-repos-intelligence package. Local analysis commands run without a cloud account and do not consume hosted credits. The opt-in cloud command family authenticates to fl-api for wallet, estimate, hosted-job, hosted-report, and publication operations. It does not call a billing provider or worker directly.

​
Install

The runtime needs the data and repository locations configured for the command you are running. Use fl-repos config init to create local configuration, then fl-repos doctor to check the effective environment.

​
Command families

Hosted submissions are estimate-first. fl-repos cloud run requires an exact --max-credits match to the current fl-api quote and an interactive confirmation unless --yes is supplied. --yes confirms the quoted cap; it does not skip estimating or permit a different maximum. python -m intelligence.cli.fl_cli is a legacy Typer HTTP client. It remains in the repository but is not the supported CLI contract and must not be used as the primary documentation source.

​
Improvement workflow

fl-repos improve targets weak quality dimensions across one repository, a profile, or the configured collection. It can plan documentation, type, test, and security-related work; re-extract and re-score changed repositories; and capture improvements on branches or pull requests when configured. Start in plan-only mode:
Useful variants:
Live improvement runs modify the selected local repositories. Review the plan, the generated diff, and any resulting pull request before merging. For the hosted organization workspace and report center, see FL Web. See CLI Commands for the complete command tree.