cli

command module

v0.1.0 Latest Latest Go to latest Published: Apr 2, 2026 License: MIT Imports: 1 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/supermodeltools/cli

Links

Open Source Insights

README ¶

Supermodel CLI

Give your AI coding agent a map of your codebase.

Supermodel CLI connects Claude Code, Codex, and other AI agents to the Supermodel API — providing call graphs, dependency graphs, dead code detection, and blast radius analysis as live context during your sessions.

Links


Website	supermodeltools.com
API Docs	api.supermodeltools.com
Dashboard	dashboard.supermodeltools.com
Twitter / X	@supermodeltools
Contact	abe@supermodel.software

What It Does

Feature	Description
Graph pregeneration	Analyze your repo upfront so your agent has instant access to call and dependency graphs without waiting mid-task
Dead code detection	Surface functions and files with no callers across TypeScript, JavaScript, Python, Go, Rust, and more
Blast radius	Before making a change, show which files and functions would be affected downstream
Token efficiency	Ship only the graph slices relevant to the current task — not the whole repo — keeping context lean
Agent integration	Plug directly into Claude Code, Codex, and Hermes as a context tool

Installation

macOS

# placeholder: brew install supermodeltools/tap/supermodel

Linux

# placeholder: install script
curl -fsSL https://supermodeltools.com/install.sh | sh

From Source

git clone https://github.com/supermodeltools/cli
cd cli
# placeholder: build instructions

Quickstart

1. Authenticate

supermodel login
# Opens your browser for GitHub OAuth

2. Pre-generate your graph

cd /path/to/your/repo
supermodel analyze
# Uploads repo, runs analysis, caches graph locally

3. Use with your agent

Claude Code:

# placeholder: MCP server config or plugin setup
supermodel claude-code install

Codex:

# placeholder: Codex tool integration
supermodel codex install

Hermes:

# placeholder: Hermes integration
supermodel hermes install

Key Commands

supermodel analyze              # Analyze the current repo and cache results
supermodel dead-code            # List functions and files with no callers
supermodel blast-radius <file>  # Show what's affected if this file changes
supermodel graph                # Print or export the graph for the current repo
supermodel status               # Show cached graph state and last analysis time
supermodel login                # Authenticate with your Supermodel account
supermodel logout               # Clear stored credentials

How It Works

supermodel analyze zips your repository and uploads it to the Supermodel API.
The API runs static analysis — building a base IR, call graph, and domain classification.
Results are cached locally (and on the API) keyed by a content hash of your repo.
Your agent tool integration reads from the cache and injects the relevant graph slice into context.

Graph data is never sent to your AI provider directly — only the slices your agent requests.

Supported Agents

Agent	Status
Claude Code	Planned — #1
Hermes	Planned — #2
Codex	Planned — #3

Pricing

Usage is metered per analysis. Run supermodel status to check your balance.

Contributing

Issues and PRs welcome. See CONTRIBUTING.md for guidelines.

Questions? Open an issue or email abe@supermodel.software.

Documentation ¶

There is no documentation for this package.

Source Files ¶

View all Source files

main.go

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd
internal
analyze Package analyze implements the `supermodel analyze` command.	Package analyze implements the `supermodel analyze` command.
api Package api provides the HTTP client and base request primitives for the Supermodel API.	Package api provides the HTTP client and base request primitives for the Supermodel API.
auth Package auth implements the `supermodel login` and `supermodel logout` commands.	Package auth implements the `supermodel login` and `supermodel logout` commands.
blastradius Package blastradius implements the `supermodel blast-radius` command.	Package blastradius implements the `supermodel blast-radius` command.
build Package build exposes version information injected at build time via ldflags.	Package build exposes version information injected at build time via ldflags.
cache Package cache manages the local graph cache stored under ~/.supermodel/cache/.	Package cache manages the local graph cache stored under ~/.supermodel/cache/.
compact Package compact provides lossless source-code compaction for reducing token usage when feeding code to AI models.	Package compact provides lossless source-code compaction for reducing token usage when feeding code to AI models.
config Package config manages the user's Supermodel configuration stored at ~/.supermodel/config.yaml.	Package config manages the user's Supermodel configuration stored at ~/.supermodel/config.yaml.
deadcode Package deadcode implements the `supermodel dead-code` command.	Package deadcode implements the `supermodel dead-code` command.
find Package find implements the `supermodel find` command — code navigation features inspired by enterprise IDE tools (find usages, call hierarchy, type hierarchy).	Package find implements the `supermodel find` command — code navigation features inspired by enterprise IDE tools (find usages, call hierarchy, type hierarchy).
focus Package focus implements the `supermodel focus` command.	Package focus implements the `supermodel focus` command.
graph Package graph implements the `supermodel graph` command.	Package graph implements the `supermodel graph` command.
mcp Package mcp implements a Model Context Protocol server that exposes Supermodel graph analysis as tools to AI coding agents (Claude Code, Hermes, Codex, and any other MCP-compatible host).	Package mcp implements a Model Context Protocol server that exposes Supermodel graph analysis as tools to AI coding agents (Claude Code, Hermes, Codex, and any other MCP-compatible host).
status Package status implements the `supermodel status` command, which prints the current authentication state, config path, API endpoint, and local cache inventory.	Package status implements the `supermodel status` command, which prints the current authentication state, config path, API endpoint, and local cache inventory.
ui Package ui provides output formatting primitives: progress spinners, tables, JSON output, and human-readable formatting helpers.	Package ui provides output formatting primitives: progress spinners, tables, JSON output, and human-readable formatting helpers.
scripts
check-architecture command Command check-architecture validates the vertical slice architecture of the Supermodel CLI using the Supermodel static analysis API.	Command check-architecture validates the vertical slice architecture of the Supermodel CLI using the Supermodel static analysis API.