Skip to main content

​
Resource URI

gitnexus://repos

​
Description

Returns a list of all repositories indexed by GitNexus. This is a global resource — it doesn’t require a repository context. Read this first to discover which repositories are available and their current state.

​
Returns

​
repos
array
List of indexed repositories

​
When to Use

  • Before any analysis: Check which repos are available
  • Multi-repo setups: Discover the correct repo name to use in tool calls
  • Index verification: Confirm a repo has been indexed

​
Example Response

​
Single Repository

repos:
  - name: "my-app"
    path: "/Users/dev/projects/my-app"
    indexed: "2024-01-15T14:32:10.123Z"
    commit: "a1b2c3d"
    files: 342
    symbols: 1248
    processes: 87

​
Multiple Repositories

repos:
  - name: "frontend"
    path: "/Users/dev/projects/frontend"
    indexed: "2024-01-15T14:32:10.123Z"
    commit: "a1b2c3d"
    files: 342
    symbols: 1248
    processes: 87
  - name: "backend"
    path: "/Users/dev/projects/backend"
    indexed: "2024-01-15T13:21:05.456Z"
    commit: "f4e5d6c"
    files: 278
    symbols: 892
    processes: 64

# Multiple repos indexed. Use repo parameter in tool calls:
# gitnexus_search({query: "auth", repo: "frontend"})

​
No Repositories

repos: []
# No repositories indexed. Run: gitnexus analyze

​
Multi-Repo Context

When multiple repositories are indexed:
  • The response includes a hint about using the repo parameter
  • All tools accept an optional repo parameter to specify which repository to query
  • Resource URIs use the repo name: gitnexus://repo/{name}/context

​
Next Steps

After reading this resource:
  1. Choose a repository from the list
  2. Read gitnexus://repo/{name}/context to get an overview and check staleness
  3. Use tools like query or context with the repo parameter if needed

Context Resource

Check repository stats and staleness

Build docs developers (and LLMs) love

Get started for freeTalk to us