Skip to content

opentrace/claude-code

Repository files navigation

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

About

Claude Code plugin for OpenTrace - provides knowledge graph tools, architecture discovery, and incident investigation capabilities via MCP

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors