Getting Started

The Bluebag CLI enables you to manage Skills directly from your terminal. Push local Skills to the cloud, pull remote Skills to your workspace, and keep everything in sync across your team.

Installation

Install the Bluebag CLI globally via npm:

npm install -g @bluebag/cli

Or use npx to run without installing:

npx @bluebag/cli

Verify the installation:

bluebag --version

Requirements

• Node.js 20 or higher
• A Bluebag account with an organization and project

Skills Directory Structure

Skills are stored in your local filesystem with the following structure:

skills/
  my-skill/
    SKILL.md              # Required: Skill definition
    script.py             # Optional: Helper scripts
    resources/            # Optional: Additional files
      data.json

Each Skill must have a SKILL.md file with YAML frontmatter:

---
name: my-skill
description: A helpful skill that does something useful
---

# My Skill

Instructions for using this skill...

Quick Start

1. Authenticate with your Bluebag account:

bluebag auth

2. Pull existing Skills from your project:

bluebag pull

3. Push local Skills to the cloud:

bluebag push

Next Steps