CLI Reference

libragen build <source> [options]

# Basic build
libragen build ./docs --name my-docs

# With version and description
libragen build ./docs \
  --name my-api \
  --description "API documentation" \
  --content-version 2.1.0

# Custom chunk settings
libragen build ./docs \
  --name my-docs \
  --chunk-size 1024 \
  --chunk-overlap 100

# Exclude patterns
libragen build ./docs \
  --name my-docs \
  --exclude "**/node_modules/**" \
  --exclude "**/test/**"

# Build from git repository
libragen build https://github.com/user/repo --name repo-docs

# Build with explicit license
libragen build ./docs --name my-docs --license MIT

# Build with multiple licenses (dual licensing)
libragen build ./docs --name my-docs --license MIT Apache-2.0

libragen query [options] <query>

# Query by library name (uses resolution algorithm)
libragen query --library my-docs "How do I authenticate?"

# Query by explicit file path
libragen query -l ./my-docs.libragen "How do I authenticate?"

# Query with custom project directory
libragen query -l my-docs -p ./my-project "error handling"

# Get more results as JSON
libragen query -l my-docs -k 20 -f json "error handling"

# Query specific version
libragen query -l my-api --content-version 2.0.0 "rate limits"

libragen list [options]

# List all libraries (auto-detected + global)
libragen list

# List with file paths shown
libragen list --show-path

# List only project-local libraries
libragen list -p ./my-project

# List from multiple specific paths
libragen list -p ./libs -p ./vendor/libs

# JSON output for scripting (includes path and location)
libragen list --json

libragen inspect <source> [options]

# Inspect a library file
libragen inspect my-lib.libragen

# Inspect a packed collection
libragen inspect my-collection.libragen-collection

# Inspect from URL
libragen inspect https://example.com/my-lib.libragen

# JSON output for scripting
libragen inspect my-lib.libragen --json

libragen install <source> [options]

# Install from file (defaults to $LIBRAGEN_HOME/libraries)
libragen install ./my-lib.libragen

# Install to a project directory (creates ./my-project/.libragen/libraries)
libragen install ./my-lib.libragen -p ./my-project

# Install to multiple project directories (first path is used for install)
libragen install ./my-lib.libragen -p ./project-a -p ./project-b

# Install from collection
libragen install react-docs

# Install from URL
libragen install https://example.com/my-lib-1.0.0.libragen

libragen uninstall <name> [options]

# Uninstall from auto-detected paths
libragen uninstall my-docs

# Uninstall from specific project only
libragen uninstall my-docs -p ./my-project

libragen update [name] [options]

# Update all libraries
libragen update

# Update specific library
libragen update react-docs

# Preview updates without applying
libragen update --dry-run

# Update only project-local libraries
libragen update -p ./my-project

libragen config [options]

libragen config

cd /my/project
libragen config

LIBRAGEN_HOME=/custom/path libragen config

libragen completions <action>

# Interactive install (prompts for shell type)
libragen completions install

# Output completion script for specific shell
libragen completions bash
libragen completions zsh
libragen completions fish

# Add to your shell profile manually
# Bash (~/.bashrc):
eval "$(libragen completions bash)"

# Zsh (~/.zshrc):
eval "$(libragen completions zsh)"

# Fish (~/.config/fish/completions/libragen.fish):
libragen completions fish > ~/.config/fish/completions/libragen.fish

# Remove completions
libragen completions uninstall