openground remove

Remove a library version from the database

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: -v

Note: 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

Related Commands

• openground list - View installed libraries
• openground nuke - Delete all data
• openground add - Add libraries back