Quickstart

Choose one path. You do not need to configure every interface before getting value.

REST API track

1. Get an operations token

Protected /api/* calls require an operations bearer token. This is not the commercial tenant credential and must never be placed in browser code.
Store it as an environment variable so you don’t paste it repeatedly:
Add this line to your ~/.zshrc or ~/.bashrc to persist it across sessions.

2. First API call

Verify the API is reachable with the health check (no auth required):
Now fetch your first list of repositories:

CLI track

First CLI command

Use uv run fl-repos --help to explore the supported command families. The legacy python -m intelligence.cli.fl_cli module is not the supported CLI contract.

Optional: plan an improvement

The Community Edition can identify weak quality dimensions and prepare targeted documentation, type, test, or security work. Start without writing changes:
See Product Model before using a live run. A live improvement run may create a branch or pull request according to your CLI configuration; generated changes still require human review.

MCP Server track

Add the MCP server to Claude Desktop so you can query the graph conversationally.

Edit your Claude Desktop config

Open (or create) ~/Library/Application Support/Claude/claude_desktop_config.json and add:

Restart Claude Desktop

After saving, restart Claude Desktop. You’ll see the FL Repos tools available in Claude’s tool list.

Try it

Ask Claude:
“Which repositories in this workspace have the highest security risk?” “Show me all Django models related to billing across all repos.” “Who are the top contributors to the core backend services?”
Claude will invoke the appropriate graph tools and return structured answers.

Next Steps

Authentication

Learn all the ways to pass credentials to the API, CLI, and MCP server.

API Reference

Explore every available endpoint with full parameter documentation.

CLI Commands

See all 15 CLI commands with usage examples.

Graph Schema

Understand the node and edge types that make up the knowledge graph.