opentrace

OpenTrace Claude Code Plugin

Connect Claude Code to your organization's indexed projects to explore code structure, dependencies, and source across repositories.

Installation

1. Add the plugin marketplace:

   /plugin marketplace add opentrace/claude-code
   

2. Install the plugin:

   /plugin install opentrace
   

3. Authenticate: On first use, you'll be prompted to sign in via your browser. After signing in, you'll see an organization-selection page — pick the org whose projects you want to explore.

Usage Examples

1. Discover Available Projects

List the projects I can explore with OpenTrace

Shows every project your organization has indexed, so you can pick one to dig into.

2. Find a Definition

Find where PaymentProcessor is defined in the billing project

Searches the project's code graph and pinpoints the file and symbol — even if the repo isn't checked out locally.

3. Trace Callers and Dependencies

What calls the validate_invoice function in the billing project?

Traverses the code graph to map callers, dependents, and dependencies of any class, function, or file.

4. Read Remote Source

Fetch the source of src/billing/processor.py from the billing project

Returns the full file content straight from the project's indexed bundle — no clone or checkout needed.

Available Tools

Tool	Purpose
list_projects	List the projects indexed for your organization
query_project	Full-text search for files, classes, and functions in a project
traverse_project	Traverse the code graph from a node (incoming, outgoing, or both)
get_project_node	Get the details of a single node
fetch_project_file	Fetch the full source of a file in a project

Troubleshooting

Problem	Solution
Authentication failed	Ensure you have an active OpenTrace account and are a member of an organization
No results found	The project may not be indexed yet, or check the name spelling
First query is slow or times out	The project bundle loads lazily on first access — retry the query once
Connection errors	Check internet connection; verify https://api.opentrace.ai is accessible

Links

• OpenTrace Documentation
• GitHub Issues