Skip to main content
The openground remove command deletes all documents for a specific library version from the local vector database.

​
Usage

openground remove <library_name> --version <version> [OPTIONS]
openground rm <library_name> --version <version> [OPTIONS]  # Shorthand alias

​
Arguments

​
library_name
string
required
Name of the library to remove

​
Options

​
--version
string
required
Version of the library to remove.Aliases: -vNote: This option is required. You must specify which version to remove.
​
--yes
boolean
default:"false"
Skip confirmation prompt.Aliases: -y

​
Behavior

​
Confirmation Prompt

Before deletion, the command shows:
  • Library name and version
  • Number of chunks to be deleted
  • Number of unique pages
  • Sample page titles (up to 3)
You must confirm unless --yes is used.

​
Raw Files

After removing from the database, the command offers to delete raw files from the raw data directory:
  • Location: ~/.openground/raw_data/{library}/{version}/
  • You can choose to keep or delete these files
This operation cannot be undone. Make sure you have backups or can re-extract the documentation.

​
Examples

​
Remove with Confirmation

openground remove langchain --version latest
Output: 
Library: langchain
Version: latest
  Chunks: 2,847
  Pages:  523
  Sample titles: Introduction, Quick Start, Installation

Are you sure you want to delete this library version? [y/N]: y

✓ Deleted 2,847 chunks for library 'langchain' version 'latest'.

Also delete raw files at /home/user/.openground/raw_data/langchain/latest? [y/N]: y
✓ Deleted raw library files at /home/user/.openground/raw_data/langchain/latest.

​
Remove Without Confirmation

openground remove mylib --version v1.0.0 -y

​
Using Shorthand Alias

openground rm mylib -v latest -y

​
Error Handling

​
Library Not Found

openground remove nonexistent --version latest
Output: 
Library 'nonexistent' version 'latest' not found.

​
Workflow

  1. Check what exists: 
    openground list-libraries
  2. Remove a library: 
    openground remove mylib --version latest
  3. Verify removal: 
    openground list-libraries

​
Removing Multiple Versions

To remove multiple versions, run the command for each: 
openground remove mylib --version v1.0.0 -y
openground remove mylib --version v2.0.0 -y
openground remove mylib --version latest -y