Command Reference

This page provides a complete reference for all Bluebag CLI commands and their options.

`bluebag auth`

Authenticate with Bluebag and configure your project.

Aliases: bluebag login, bluebag setup

Usage:

bluebag auth

Behavior:

Opens your browser to the Bluebag authentication page
Displays a verification code in your terminal
Waits for you to approve the device authorization
Prompts you to select an organization and project
Creates a .bluebagrc configuration file

Example:

bluebag auth

`bluebag logout`

Clear stored authentication credentials.

Usage:

bluebag logout [options]

Options:

Option	Description
`--api-url <url>`	Target a specific API URL (advanced)

Example:

bluebag logout

`bluebag push`

Push local Skills to your Bluebag project.

Usage:

bluebag push [skills...] [options]

Arguments:

Argument	Description
`skills`	Optional list of specific Skill names

Options:

Option	Alias	Description
`--force`	`-f`	Overwrite remote changes without prompting
`--dry-run`	`-n`	Preview changes without uploading

Examples:

# Push all skills
bluebag push

# Push a specific skill
bluebag push my-skill

# Push multiple skills
bluebag push skill-1 skill-2

# Force push (overwrite remote)
bluebag push --force

# Preview without uploading
bluebag push --dry-run

# Combine options
bluebag push my-skill --dry-run

`bluebag pull`

Pull remote Skills to your local workspace.

Usage:

bluebag pull [skills...] [options]

Arguments:

Argument	Description
`skills`	Optional list of specific Skill names

Options:

Option	Alias	Description
`--force`	`-f`	Overwrite local changes without prompting
`--dry-run`	`-n`	Preview changes without downloading

Examples:

# Pull all skills
bluebag pull

# Pull a specific skill
bluebag pull my-skill

# Pull multiple skills
bluebag pull skill-1 skill-2

# Force pull (overwrite local)
bluebag pull --force

# Preview without downloading
bluebag pull --dry-run

# Combine options
bluebag pull my-skill --dry-run

`bluebag --version`

Display the CLI version.

Usage:

bluebag --version

Example output:

1.2.3

`bluebag --help`

Display help information.

Usage:

bluebag --help
bluebag <command> --help

Examples:

# General help
bluebag --help

# Command-specific help
bluebag push --help

Environment Variables

`BLUEBAG_OPEN_BROWSER`

Control automatic browser opening during authentication.

Value	Behavior
`1`	Open browser automatically (default)
`0`	Don't open browser; show URL instead

Example:

export BLUEBAG_OPEN_BROWSER=0
bluebag auth

Configuration File

The .bluebagrc file stores your project configuration.

Location: Project root directory

Format: JSON

Fields:

Field	Type	Description
`organizationId`	string	Your Bluebag organization ID
`projectId`	string	The project to sync Skills with
`skillsDir`	string	Local directory for Skills (default: `skills`)

Example:

{
  "organizationId": "org_abc123",
  "projectId": "prj_xyz789",
  "skillsDir": "skills"
}

Exit Codes

Code	Meaning
`0`	Success
`1`	General error
`2`	Validation error
`3`	Authentication error
`4`	Network error

Quick Reference

Command	Description
`bluebag auth`	Authenticate and configure
`bluebag logout`	Clear credentials
`bluebag push`	Push all Skills
`bluebag push <name>`	Push specific Skill
`bluebag push --force`	Push, overwriting remote
`bluebag push --dry-run`	Preview push
`bluebag pull`	Pull all Skills
`bluebag pull <name>`	Pull specific Skill
`bluebag pull --force`	Pull, overwriting local
`bluebag pull --dry-run`	Preview pull
`bluebag --version`	Show version
`bluebag --help`	Show help

Command Reference

On this page