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.
~/.zshrc or ~/.bashrc to persist it across sessions.
2. First API call
Verify the API is reachable with the health check (no auth required):CLI track
First CLI command
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: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.