CLI tool for managing projects on bool.com.

npm install -g bool-cli

This installs the bool command globally.

bool auth login      # Paste your API key from the bool.com web UI
bool auth status     # Verify connection

Your API key is saved to ~/.config/bool-cli/config.json. You can also set the BOOL_API_KEY environment variable.

The fastest way to get code live — no account or API key required:

bool shipit [directory]

Creates an anonymous Bool and uploads files in one step. On subsequent runs from the same directory, it updates the existing Bool automatically (tracked via .bool/config).

Aliases:

• bool ls for bool list
• bool get / bool info for bool show
• bool rm for bool delete

Deprecated but still supported:

• bool bools ... commands now print a deprecation warning and map to top-level commands.
• bool bools visibility ... is deprecated; use bool update [slug] --visibility <value>.

Slug resolution: When [slug] is omitted, commands read it from the .bool/config file in the current directory. This file is created automatically by shipit, deploy, pull, and show (or info alias).

bool deploy my-project ./src --message "Added dark mode" --exclude "*.test.js"

• Auto-create: If no slug is provided and .bool/config doesn't exist, a new Bool is created automatically (named after the directory)
• --message / -m — Commit message
• --exclude — Exclude pattern (repeatable)
• Binary files are automatically skipped
• Respects .boolignore files (gitignore syntax)
• Default excludes: .git, node_modules, __pycache__, .DS_Store, .bool
• Live URL: Displayed in output after successful deployment

bool pull my-project ./local-copy --version 3

• --version — Specific version number (default: latest)

All commands support --json for machine-readable output:

bool list --json
bool show my-project --json

Running shipit, deploy, pull, or show creates a .bool/config file in the project directory. This JSON file stores slug and name so you can run commands without specifying the slug each time:

cd my-project
bool deploy              # slug read from .bool/config
bool show                # slug read from .bool/config
bool versions            # slug read from .bool/config

Add .bool/ to your .gitignore.

bool-cli/
  bin/
    bool.js              # Entry point
  src/
    commands/
      auth.js            # auth login, auth status
      bools.js           # top-level bool commands (+ deprecated bools wrappers)
      shipit.js          # shipit (anonymous create + deploy)
      versions.js        # versions, deploy, pull
    utils/
      api.js             # API client (fetch-based)
      config.js          # Global config + project-level .bool/config
      files.js           # File reading, .boolignore, binary detection
      output.js          # Output formatting (tables, colors, JSON)