diff --git a/cli/commands/analyze.mdx b/cli/commands/analyze.mdx new file mode 100644 index 0000000..c6cb2d9 --- /dev/null +++ b/cli/commands/analyze.mdx @@ -0,0 +1,40 @@ +--- +title: 'analyze' +description: 'Upload a repository and run the full analysis pipeline' +--- + +Archives the repository, uploads it to the Supermodel API, and runs call graph generation, dependency analysis, and domain classification. Results are cached locally by content hash. Subsequent commands (`dead-code`, `blast-radius`, `graph`) reuse the cache automatically. + +By default, `.graph.*` shard files are written next to each source file. Pass `--no-shards` to skip writing graph files. + +## Synopsis + +```bash +supermodel analyze [path] [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `--three-file` | Generate `.calls`/`.deps`/`.impact` files instead of a single `.graph` | +| `--no-shards` | Skip writing `.graph.*` shard files | +| `--force` | Re-analyze even if a cached result exists | +| `-o, --output` | Output format: `human` \| `json` | +| `-h, --help` | Help for analyze | + +## Examples + +```bash +# Analyze the current directory +supermodel analyze + +# Generate three-file shards (recommended) +supermodel analyze --three-file + +# Re-analyze without using the cache, output JSON +supermodel analyze --force -o json + +# Run analysis without writing sidecar files +supermodel analyze --no-shards +``` diff --git a/cli/commands/audit.mdx b/cli/commands/audit.mdx new file mode 100644 index 0000000..4af816f --- /dev/null +++ b/cli/commands/audit.mdx @@ -0,0 +1,32 @@ +--- +title: 'audit' +description: 'Codebase health report from graph intelligence' +--- + +Analyses the codebase via the Supermodel API and produces a structured Markdown health report covering: + +- Overall status (HEALTHY / DEGRADED / CRITICAL) +- Circular dependency detection +- Domain coupling metrics and high-coupling domains +- High blast-radius files +- Prioritised recommendations + +## Synopsis + +```bash +supermodel audit [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `--dir` | Project directory (default: current working directory) | +| `-h, --help` | Help for audit | + +## Examples + +```bash +supermodel audit +supermodel audit --dir ./path/to/project +``` diff --git a/cli/commands/blast-radius.mdx b/cli/commands/blast-radius.mdx new file mode 100644 index 0000000..a4f129b --- /dev/null +++ b/cli/commands/blast-radius.mdx @@ -0,0 +1,45 @@ +--- +title: 'blast-radius' +description: 'Analyze the impact of changing a file or function' +--- + +Uploads the repository to the Supermodel API and runs impact analysis using call graph and dependency graph reachability. Results include risk scoring, affected files and functions, and entry points that would be impacted by changes to the target. + +**Aliases:** `br`, `impact` + +## Synopsis + +```bash +supermodel blast-radius [file...] [flags] +``` + +Three usage modes: + +```bash +supermodel blast-radius # analyze a specific file +supermodel blast-radius --diff changes.diff # analyze from a git diff +supermodel blast-radius # global coupling map +``` + +## Flags + +| Flag | Description | +|---|---| +| `--diff` | Path to a unified diff file (git diff output) | +| `--force` | Re-analyze even if a cached result exists | +| `-o, --output` | Output format: `human` \| `json` | +| `-h, --help` | Help for blast-radius | + +## Examples + +```bash +# Impact of changing one file +supermodel blast-radius internal/api/client.go + +# Impact of a pending PR +git diff main...HEAD > /tmp/pr.diff +supermodel blast-radius --diff /tmp/pr.diff + +# Global coupling map (no target) +supermodel blast-radius -o json +``` diff --git a/cli/commands/clean.mdx b/cli/commands/clean.mdx new file mode 100644 index 0000000..1400799 --- /dev/null +++ b/cli/commands/clean.mdx @@ -0,0 +1,27 @@ +--- +title: 'clean' +description: 'Remove all .graph.* files from the repository' +--- + +Removes every `.graph.*` sidecar file from the repository. + +## Synopsis + +```bash +supermodel clean [path] [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `--dry-run` | Show what would be removed without removing | +| `-h, --help` | Help for clean | + +## Examples + +```bash +supermodel clean +supermodel clean --dry-run +supermodel clean ./my-project +``` diff --git a/cli/commands/compact.mdx b/cli/commands/compact.mdx new file mode 100644 index 0000000..1ec0300 --- /dev/null +++ b/cli/commands/compact.mdx @@ -0,0 +1,39 @@ +--- +title: 'compact' +description: 'Reduce token usage of source code while preserving semantics' +--- + +Strips comments, removes blank lines, and shortens local identifiers to produce token-efficient source code that remains syntactically valid and semantically identical (all tests still pass). + +Supports Go, Python, TypeScript, JavaScript, and Rust. + +For a single file, compacted output is written to stdout. For a directory, files are written to `--output` (default: `./compacted/`). + +**Aliases:** `pack`, `minify` + +## Synopsis + +```bash +supermodel compact [path] [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `-o, --output` | Output directory for directory mode (default `compacted`) | +| `--dry-run` | Print stats without writing files | +| `-h, --help` | Help for compact | + +## Examples + +```bash +# Single file → stdout +supermodel compact internal/api/client.go + +# Whole repo → ./compacted/ +supermodel compact . + +# See savings without writing +supermodel compact --dry-run . +``` diff --git a/cli/commands/dead-code.mdx b/cli/commands/dead-code.mdx new file mode 100644 index 0000000..c0f9dd3 --- /dev/null +++ b/cli/commands/dead-code.mdx @@ -0,0 +1,39 @@ +--- +title: 'dead-code' +description: 'Find unreachable functions using static analysis' +--- + +Uploads the repository to the Supermodel API and runs multi-phase dead code analysis including call graph reachability, entry point detection, and transitive propagation. Results include confidence levels (high/medium/low), line numbers, and explanations for why each function was flagged. + +**Aliases:** `dc` + +## Synopsis + +```bash +supermodel dead-code [path] [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `--min-confidence` | Minimum confidence: `high`, `medium`, or `low` | +| `--limit` | Maximum number of candidates to return | +| `--ignore` | Glob pattern to exclude (repeatable, supports `**`) | +| `--timeout` | Maximum seconds to wait (default `7200`, `0` = no limit) | +| `--force` | Re-analyze even if a cached result exists | +| `-o, --output` | Output format: `human` \| `json` | +| `-h, --help` | Help for dead-code | + +## Examples + +```bash +# High-confidence candidates only +supermodel dead-code --min-confidence high + +# Top 20 results, JSON output +supermodel dead-code --limit 20 -o json + +# Skip vendored and generated code +supermodel dead-code --ignore '**/vendor/**' --ignore '**/*_pb.go' +``` diff --git a/cli/commands/docs.mdx b/cli/commands/docs.mdx new file mode 100644 index 0000000..1a9868e --- /dev/null +++ b/cli/commands/docs.mdx @@ -0,0 +1,40 @@ +--- +title: 'docs' +description: 'Generate static architecture documentation for a repository' +--- + +Generates a static HTML site documenting the architecture of a codebase. The command uploads the repository to the Supermodel API, converts the returned code graph to markdown, and builds a browsable static site with search, dependency graphs, taxonomy navigation, and SEO metadata. The site also emits machine-readable artifacts (JSON-LD and `LLMS.txt`) alongside the HTML. + +The output directory can be served locally or deployed to any static host (GitHub Pages, Vercel, Netlify, Cloudflare Pages). + +## Synopsis + +```bash +supermodel docs [path] [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `-o, --output` | Output directory (default `./docs-output`) | +| `--repo` | GitHub repo slug `owner/repo` for source links | +| `--base-url` | Canonical base URL where the site will be hosted (default `https://example.com`) | +| `--site-name` | Display title for the generated site (default ` Architecture Docs`) | +| `--max-entities` | Cap on entity pages (default `12000`, `0` = unlimited) | +| `--max-source-files` | Cap on source files in analysis (default `3000`, `0` = unlimited) | +| `--templates-dir` | Override bundled HTML/CSS/JS templates with a custom directory | +| `--force` | Bypass cache and re-upload even if a cached result exists | +| `-h, --help` | Help for docs | + +## Examples + +```bash +supermodel docs + +supermodel docs ./my-project --output ./docs-site + +supermodel docs --repo owner/repo --base-url https://owner.github.io/repo + +supermodel docs --site-name "My App Docs" --output /var/www/html +``` diff --git a/cli/commands/find.mdx b/cli/commands/find.mdx new file mode 100644 index 0000000..fc60482 --- /dev/null +++ b/cli/commands/find.mdx @@ -0,0 +1,36 @@ +--- +title: 'find' +description: 'Find usages and callers of a symbol across the codebase' +--- + +Searches the graph for all nodes matching the given symbol name (substring match, case-insensitive) and prints their call relationships. + +Similar to "Find Usages" in IDEs — without requiring a language server. + +## Synopsis + +```bash +supermodel find [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `--kind` | Filter by node label: `Function`, `File`, `Class`, … | +| `--force` | Re-analyze even if cache is fresh | +| `-o, --output` | Output format: `human` \| `json` | +| `-h, --help` | Help for find | + +## Examples + +```bash +# Find anything containing this name +supermodel find handleRequest + +# Restrict to classes +supermodel find Client --kind Class + +# JSON output for tool consumption +supermodel find parse -o json +``` diff --git a/cli/commands/focus.mdx b/cli/commands/focus.mdx new file mode 100644 index 0000000..2ad95fe --- /dev/null +++ b/cli/commands/focus.mdx @@ -0,0 +1,38 @@ +--- +title: 'focus' +description: 'Token-efficient graph slice for a single file' +--- + +Extracts the minimal graph context relevant to the given file: direct imports, functions defined, callers, and (optionally) type declarations. + +Output is structured markdown for direct injection into LLM context windows, keeping token usage minimal while preserving semantic relevance. Use `--output json` for structured consumption by tools. + +**Aliases:** `ctx`, `context` + +## Synopsis + +```bash +supermodel focus [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `--depth` | Import traversal depth (default `1`) | +| `--types` | Include type/class declarations | +| `--force` | Re-analyze even if cache is fresh | +| `-o, --output` | Output format: `markdown` \| `json` (default `markdown`) | +| `-h, --help` | Help for focus | + +## Examples + +```bash +supermodel focus internal/api/client.go + +# Walk imports two hops deep, include types +supermodel focus internal/api/client.go --depth 2 --types + +# JSON for tool consumption +supermodel focus internal/api/client.go -o json +``` diff --git a/cli/commands/graph.mdx b/cli/commands/graph.mdx new file mode 100644 index 0000000..130d799 --- /dev/null +++ b/cli/commands/graph.mdx @@ -0,0 +1,37 @@ +--- +title: 'graph' +description: 'Display the repository graph' +--- + +Fetches or loads the cached graph and renders it in one of three formats: + +- `human` — aligned table of nodes (default) +- `json` — full graph as JSON +- `dot` — Graphviz DOT for use with `dot`/`graphviz` + +## Synopsis + +```bash +supermodel graph [path] [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `--label` | Filter nodes by label (`File`, `Function`, `Class`, …) | +| `--force` | Re-analyze even if a cached result exists | +| `-o, --output` | Output format: `human` \| `json` \| `dot` (default `human`) | +| `-h, --help` | Help for graph | + +## Examples + +```bash +supermodel graph + +# Only files +supermodel graph --label File + +# Render with Graphviz +supermodel graph -o dot | dot -Tsvg > graph.svg +``` diff --git a/cli/commands/hook.mdx b/cli/commands/hook.mdx new file mode 100644 index 0000000..8089afa --- /dev/null +++ b/cli/commands/hook.mdx @@ -0,0 +1,36 @@ +--- +title: 'hook' +description: 'Forward Claude Code file-change events to the watch daemon' +--- + +Reads a Claude Code `PostToolUse` JSON payload from stdin and forwards the file path to the running watch daemon via UDP. Install as a `PostToolUse` hook in `.claude/settings.json`. + +## Synopsis + +```bash +supermodel hook [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `--port` | UDP port of the watch daemon (default `7734`) | +| `-h, --help` | Help for hook | + +## Example + +Add to `.claude/settings.json`: + +```json +{ + "hooks": { + "PostToolUse": [{ + "matcher": "Write|Edit", + "hooks": [{ "type": "command", "command": "supermodel hook" }] + }] + } +} +``` + +The `supermodel setup` wizard installs this automatically when Claude Code is detected. diff --git a/cli/commands/login.mdx b/cli/commands/login.mdx new file mode 100644 index 0000000..4e64914 --- /dev/null +++ b/cli/commands/login.mdx @@ -0,0 +1,31 @@ +--- +title: 'login' +description: 'Authenticate with your Supermodel account' +--- + +Opens your browser to create an API key and automatically saves it to `~/.supermodel/config.yaml`. + +For CI or headless environments, pass the key directly with `--token`. + +## Synopsis + +```bash +supermodel login [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `--token` | API key for non-interactive login (CI) | +| `-h, --help` | Help for login | + +## Examples + +```bash +# Browser-based login +supermodel login + +# Non-interactive (CI) +supermodel login --token smsk_live_... +``` diff --git a/cli/commands/logout.mdx b/cli/commands/logout.mdx new file mode 100644 index 0000000..0ab7eb6 --- /dev/null +++ b/cli/commands/logout.mdx @@ -0,0 +1,18 @@ +--- +title: 'logout' +description: 'Remove stored credentials' +--- + +Removes the API key from `~/.supermodel/config.yaml`. + +## Synopsis + +```bash +supermodel logout [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `-h, --help` | Help for logout | diff --git a/cli/commands/mcp.mdx b/cli/commands/mcp.mdx new file mode 100644 index 0000000..90ce2c3 --- /dev/null +++ b/cli/commands/mcp.mdx @@ -0,0 +1,43 @@ +--- +title: 'mcp' +description: 'Start the Model Context Protocol server' +--- + +Starts a stdio MCP server that exposes Supermodel graph analysis as tools to MCP-compatible hosts. + +## Synopsis + +```bash +supermodel mcp [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `--repo` | Path to the repository root (default `.`) | +| `-h, --help` | Help for mcp | + +## Exposed tools + +| Tool | Description | +|---|---| +| `analyze` | Upload repo and run full analysis | +| `dead_code` | Find functions with no callers | +| `blast_radius` | Find files affected by a change | +| `get_graph` | Return a filtered graph slice | + +## Example + +Add to `~/.claude/config.json`: + +```json +{ + "mcpServers": { + "supermodel": { + "command": "supermodel", + "args": ["mcp"] + } + } +} +``` diff --git a/cli/commands/restore.mdx b/cli/commands/restore.mdx new file mode 100644 index 0000000..8857945 --- /dev/null +++ b/cli/commands/restore.mdx @@ -0,0 +1,38 @@ +--- +title: 'restore' +description: "Generate a project context summary to restore an agent's understanding" +--- + +Builds a high-level project summary (a "context bomb") and writes it to stdout. Use it after Claude Code compacts its context window to re-establish understanding of your codebase structure, domains, and key files. + +With an API key configured (run `supermodel login`), `restore` calls the Supermodel API for an AI-powered analysis including semantic domains, external dependencies, and critical file ranking. + +Without an API key (or with `--local`), `restore` performs a local scan of the repository file tree and produces a simpler structural summary. + +## Synopsis + +```bash +supermodel restore [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `--dir` | Project directory (default: cwd) | +| `--local` | Use local file scan instead of the Supermodel API | +| `--max-tokens` | Maximum token budget for the output (default `2000`) | +| `-h, --help` | Help for restore | + +## Examples + +```bash +# Pipe into your agent (typical use) +supermodel restore + +# Local-only, no API call +supermodel restore --local + +# Larger budget for big repos +supermodel restore --max-tokens 4000 +``` diff --git a/cli/commands/setup.mdx b/cli/commands/setup.mdx new file mode 100644 index 0000000..00fc493 --- /dev/null +++ b/cli/commands/setup.mdx @@ -0,0 +1,18 @@ +--- +title: 'setup' +description: 'Interactive setup wizard' +--- + +Walks through authentication, repository selection, file mode, and Claude Code hook installation. + +## Synopsis + +```bash +supermodel setup [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `-h, --help` | Help for setup | diff --git a/cli/commands/share.mdx b/cli/commands/share.mdx new file mode 100644 index 0000000..c95a9eb --- /dev/null +++ b/cli/commands/share.mdx @@ -0,0 +1,26 @@ +--- +title: 'share' +description: 'Upload your codebase health report and get a public URL' +--- + +Runs a health audit and uploads the report to supermodeltools.com, returning a short public URL you can share or embed as a README badge. + +## Synopsis + +```bash +supermodel share [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `--dir` | Project directory (default: cwd) | +| `-h, --help` | Help for share | + +## Examples + +```bash +supermodel share +supermodel share --dir ./path/to/project +``` diff --git a/cli/commands/skill.mdx b/cli/commands/skill.mdx new file mode 100644 index 0000000..0706ba6 --- /dev/null +++ b/cli/commands/skill.mdx @@ -0,0 +1,26 @@ +--- +title: 'skill' +description: 'Print agent awareness prompt for graph files' +--- + +Prints a prompt that teaches AI coding agents how to use Supermodel's `.graph.*` sidecar files. Pipe into your agent's instructions file. + +## Synopsis + +```bash +supermodel skill +``` + +## Flags + +| Flag | Description | +|---|---| +| `-h, --help` | Help for skill | + +## Examples + +```bash +supermodel skill >> CLAUDE.md +supermodel skill >> AGENTS.md +supermodel skill >> .cursorrules +``` diff --git a/cli/commands/status.mdx b/cli/commands/status.mdx new file mode 100644 index 0000000..04b7c6f --- /dev/null +++ b/cli/commands/status.mdx @@ -0,0 +1,19 @@ +--- +title: 'status' +description: 'Show authentication and cache status' +--- + +Prints the current authentication state and cache location. + +## Synopsis + +```bash +supermodel status [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `-o, --output` | Output format: `human` \| `json` | +| `-h, --help` | Help for status | diff --git a/cli/commands/update.mdx b/cli/commands/update.mdx new file mode 100644 index 0000000..2b4782f --- /dev/null +++ b/cli/commands/update.mdx @@ -0,0 +1,29 @@ +--- +title: 'update' +description: 'Update supermodel to the latest release' +--- + +Checks for a newer release on GitHub and, if found, downloads and installs it. Independent of authentication — works without an API key. + +## Synopsis + +```bash +supermodel update [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `--check` | Print the latest available version without installing | +| `-h, --help` | Help for update | + +## Examples + +```bash +# Install the latest release +supermodel update + +# Just check +supermodel update --check +``` diff --git a/cli/commands/version.mdx b/cli/commands/version.mdx new file mode 100644 index 0000000..943dff7 --- /dev/null +++ b/cli/commands/version.mdx @@ -0,0 +1,16 @@ +--- +title: 'version' +description: 'Print version information' +--- + +## Synopsis + +```bash +supermodel version [flags] +``` + +## Flags + +| Flag | Description | +|---|---| +| `-h, --help` | Help for version | diff --git a/cli/commands/watch.mdx b/cli/commands/watch.mdx new file mode 100644 index 0000000..022753b --- /dev/null +++ b/cli/commands/watch.mdx @@ -0,0 +1,44 @@ +--- +title: 'supermodel' +description: 'Run the watch daemon (the bare command)' +--- + +Runs a full analysis on startup (using the cached graph if available), then enters daemon mode. Listens for file-change notifications from the `supermodel hook` command and incrementally re-renders affected `.graph.*` sidecar files. Press Ctrl+C to stop and remove graph files. + +## Synopsis + +```bash +supermodel [flags] +``` + +## Description + +The bare `supermodel` command is the watch daemon. It does not take a subcommand — running it with no arguments starts the long-running process. + +By default the daemon listens on UDP (port `7734`) for change notifications pushed by `supermodel hook`. For environments without a hook integration, pass `--fs-watch` to also poll git state (`HEAD`, index mtime, dirty files) every `--poll-interval`. + +## Flags + +| Flag | Default | Description | +|---|---|---| +| `--dir` | `.` | Project directory | +| `--cache-file` | — | Override cache file path | +| `--debounce` | `2s` | Debounce duration before processing changes | +| `--notify-port` | `7734` | UDP port for hook notifications | +| `--fs-watch` | off | Also poll git state (use when no hook is installed) | +| `--poll-interval` | `3s` | Git poll interval (only when `--fs-watch` is set) | +| `-v, --version` | — | Print version and exit | +| `-h, --help` | — | Help for supermodel | + +## Examples + +```bash +# Start the daemon in the current directory +supermodel + +# Watch a specific project, poll git state as a fallback +supermodel --dir ./my-project --fs-watch + +# Use a custom UDP port if 7734 is taken +supermodel --notify-port 9000 +``` diff --git a/cli/install.mdx b/cli/install.mdx new file mode 100644 index 0000000..a0a516a --- /dev/null +++ b/cli/install.mdx @@ -0,0 +1,48 @@ +--- +title: 'Installation' +description: 'Install the Supermodel CLI' +icon: 'download' +--- + +A single Go binary, no runtime dependencies. + +## Homebrew + +```bash +brew install supermodeltools/tap/supermodel +``` + +## curl + +```bash +curl -fsSL https://supermodeltools.com/install.sh | sh +``` + +## npm + +```bash +npm install -g @supermodeltools/cli +``` + +## From source + +```bash +git clone https://github.com/supermodeltools/cli +cd cli +go build -o supermodel . +``` + +## Update + +```bash +supermodel update # install latest release +supermodel update --check # check without installing +``` + +## Uninstall + +```bash +supermodel logout +rm -rf ~/.supermodel +brew uninstall supermodel # or remove the binary from your PATH +``` diff --git a/cli/quickstart.mdx b/cli/quickstart.mdx new file mode 100644 index 0000000..91ffa83 --- /dev/null +++ b/cli/quickstart.mdx @@ -0,0 +1,54 @@ +--- +title: 'Quickstart' +description: 'Authenticate and run your first analysis' +icon: 'bolt' +--- + +## 1. Authenticate + +```bash +supermodel login +``` + +Opens your browser, creates an API key, and saves it to `~/.supermodel/config.yaml`. For CI, pass the key directly: + +```bash +supermodel login --token smsk_live_... +``` + +## 2. Analyze a repo + +```bash +cd /path/to/your/repo +supermodel analyze +``` + +Uploads the repo, runs call graph + dependency + domain analysis, caches the result locally by content hash, and writes `.graph.*` sidecar files next to each source file. + +## 3. Use the results + +| Goal | Command | +|---|---| +| Find unreachable functions | `supermodel dead-code` | +| See what a change impacts | `supermodel blast-radius path/to/file.go` | +| Codebase health report | `supermodel audit` | +| Find usages of a symbol | `supermodel find handleRequest` | +| Token-efficient context for one file | `supermodel focus path/to/file.go` | +| Print the full graph | `supermodel graph` | + +Subsequent commands reuse the cached graph automatically. Pass `--force` to any command to bypass the cache. + +## 4. Configure (optional) + +Settings live at `~/.supermodel/config.yaml`. Environment variables override file values. + +```yaml +api_key: smsk_live_... # or SUPERMODEL_API_KEY +api_base: https://api.supermodeltools.com # or SUPERMODEL_API_BASE +output: human # human | json +files: true # set false (or SUPERMODEL_FILES=false) to skip writing sidecars +``` + +## Next + +See the [command reference](/cli/commands/analyze) for every command, flag, and example. diff --git a/docs.json b/docs.json index 7a35bc9..054f38f 100644 --- a/docs.json +++ b/docs.json @@ -42,6 +42,45 @@ } ] }, + { + "tab": "CLI", + "groups": [ + { + "group": "Get started", + "pages": [ + "cli/install", + "cli/quickstart" + ] + }, + { + "group": "Commands", + "pages": [ + "cli/commands/watch", + "cli/commands/analyze", + "cli/commands/audit", + "cli/commands/blast-radius", + "cli/commands/clean", + "cli/commands/compact", + "cli/commands/dead-code", + "cli/commands/docs", + "cli/commands/find", + "cli/commands/focus", + "cli/commands/graph", + "cli/commands/hook", + "cli/commands/login", + "cli/commands/logout", + "cli/commands/mcp", + "cli/commands/restore", + "cli/commands/setup", + "cli/commands/share", + "cli/commands/skill", + "cli/commands/status", + "cli/commands/update", + "cli/commands/version" + ] + } + ] + }, { "tab": "API Reference", "openapi": "/openapi.yaml" diff --git a/index.mdx b/index.mdx index 46ea2d4..0925a1e 100644 --- a/index.mdx +++ b/index.mdx @@ -11,14 +11,13 @@ Supermodel provides a unified graph representation of your codebase, enabling po **Try the API Playground**: Each endpoint in our API Reference includes an interactive playground. To use it, you'll need an API key from the [Supermodel Dashboard](https://dashboard.supermodeltools.com/). -## API Reference +## Where to start -Explore our data plane endpoints to generate graphs from your code: - - - View the OpenAPI specification and endpoints - + + + View the OpenAPI specification and endpoints. + + + Install the Supermodel CLI and start analyzing repositories from your terminal. + +