Skip to main content
View and manage OpenGround usage statistics, including library counts and tool call metrics.

Commands

show

Display OpenGround statistics.
openground stats show

Output Example

Openground Statistics
==================================================
Libraries: 5
Total chunks: 12,847

Tool calls:
  query: 127
  add: 8
  update: 3
  remove: 2
  list: 15

Metrics

  • Libraries: Number of distinct libraries in the database
  • Total chunks: Total number of embedded chunks across all libraries
  • Tool calls: Count of each command execution

reset

Clear tool call statistics (reset to zero).
openground stats reset [OPTIONS]

Options

--yes
boolean
default:"false"
Skip confirmation prompt.Aliases: -y
This permanently clears all tool call statistics. Library and chunk counts will remain.

Example

openground stats reset
Output:
Are you sure you want to clear all tool call statistics? [y/N]: y
✓ Statistics cleared. Tool call counts reset to zero.

With Auto-Confirm

openground stats reset -y

Use Cases

Monitor Usage

Check how often you’re querying documentation:
openground stats show

Track Library Growth

See total chunks as you add more documentation:
openground stats show
# Add a library
openground add newlib -s https://example.com/docs
# Check again
openground stats show

Reset After Testing

Clear stats after testing or development:
openground stats reset -y

Statistics Storage

Statistics are stored in the LanceDB database and updated automatically:
  • Location: Within the configured db_path
  • Updates: Real-time as commands are executed
  • Persistence: Survives application restarts

What Gets Tracked

Tool calls tracked:
  • query - Search queries
  • add - Adding/updating libraries
  • update - Explicit updates
  • remove - Removing libraries
  • list - Listing libraries
  • Other commands as executed

What Doesn’t Get Tracked

  • Personal data: No query content is stored
  • URLs or sources: No external URLs tracked
  • Configuration changes: Config edits not tracked
  • Help commands: --help not tracked