Skip to content

CLI Commands

CLI Commands ReferenceLink

This is the complete reference for all 14 Sierra Dev CLI commands. These commands allow you to manage repositories, install packages, and maintain your environment.

đŸ“Ļ Repository CommandsLink

Manage the sources where Sierra Dev looks for packages.

sierra-dev repo addLink

Add a GitHub repository as a package source.

Syntax:

Bash
1
sierra-dev repo add <url> [options]

Options: - --name <name>: Custom name for the source (e.g., "community"). - --branch <branch>: Git branch to use (default: main). - --priority <n>: Priority level (lower number = higher priority). Default is 10.

Examples:

Bash
1
2
sierra-dev repo add https://github.com/xsyncio/sierra-invokers
sierra-dev repo add https://github.com/my-org/private-tools --name private --priority 1

sierra-dev repo listLink

List all configured repositories and their status.

Syntax:

Bash
1
sierra-dev repo list

Output: Displays a table of sources, their URLs, priorities, and enabled status.

sierra-dev repo updateLink

Fetch the latest package registries from all configured sources.

Syntax:

Bash
1
sierra-dev repo update [source]

Arguments: - source (optional): Update only a specific source by name.

Examples:

Bash
1
2
sierra-dev repo update          # Update all
sierra-dev repo update official # Update only 'official'

sierra-dev repo removeLink

Remove a repository source.

Syntax:

Bash
1
sierra-dev repo remove <name>

🔍 Discovery CommandsLink

Find and explore available packages.

Search for packages across all repositories.

Syntax:

Bash
1
sierra-dev search <query> [options]

Options: - --tag <tag>: Filter by tag (e.g., "osint"). - --category <cat>: Filter by category. - --source <src>: Filter by source repository.

Examples:

Bash
1
2
sierra-dev search email
sierra-dev search --tag vulnerability

sierra-dev infoLink

Show detailed information about a specific package.

Syntax:

Bash
1
sierra-dev info <package>

Output: Displays description, author, version, source, tags, and installation instructions.

đŸ’ŋ Package ManagementLink

Install, update, and remove packages.

sierra-dev installLink

Install one or more packages into your environment.

Syntax:

Bash
1
sierra-dev install <package>... [options]

Options: - --env <name>: Target environment (default: test_env). - --force: Force re-installation even if already installed. - --skip-validation: Bypass type safety checks (use with caution).

Examples:

Bash
1
2
sierra-dev install digital-footprint
sierra-dev install pkg1 pkg2 pkg3 --env production

sierra-dev updateLink

Update installed packages to the latest version.

Syntax:

Bash
1
sierra-dev update [package] [--all]

Options: - --all: Update ALL installed packages. - --env <name>: Target environment.

Examples:

Bash
1
2
sierra-dev update digital-footprint
sierra-dev update --all

sierra-dev upgradableLink

List all packages that have updates available.

Syntax:

Bash
1
sierra-dev upgradable

sierra-dev removeLink

Uninstall a package.

Syntax:

Bash
1
sierra-dev remove <package>

sierra-dev listLink

List available or installed packages.

Syntax:

Bash
1
sierra-dev list [options]

Options: - --installed: Show only installed packages. - --env <name>: Target environment.

🛠ī¸ Development & HealthLink

Maintain and validate your environment.

sierra-dev initLink

Initialize a new Sierra environment.

Bash
1
sierra-dev init [name] [--force]
  • name: Name of the environment directory (default: default_env)
  • --force: Overwrite existing configuration if present

sierra-dev cleanLink

Clean generated files from the environment.

Bash
1
sierra-dev clean [--env ENV]
  • --env: Target environment (default: default_env)

sierra-dev buildLink

Compile invoker scripts and generate configuration.

Syntax:

Bash
1
sierra-dev build [options]

Options: - --env <name>: Target environment. - -v, --verbose: Enable debug logging.

sierra-dev checkLink

Run comprehensive validation checks on your invokers.

Syntax:

Bash
1
sierra-dev check [options]

Checks Performed: - YAML configuration validity - Parameter definitions - Type annotations - Reserved keywords

sierra-dev healthLink

Check the overall health of the Sierra Dev environment.

Syntax:

Bash
1
sierra-dev health

Checks Performed: - Configuration existence - Directory structure - Virtual environment status - Permission checks

ℹī¸ Global OptionsLink

These options apply to all commands:

  • -h, --help: Show help message and exit.
  • -v, --verbose: Enable verbose output (debug logs).

💡 TipsLink

  • Use sierra-dev repo update frequently to get the latest package versions.
  • Use sierra-dev check before building to catch errors early.
  • Combine sierra-dev search with tags for precise discovery.