crow-cli

CLI tool for managing Crow skills, rules, and workflows across AI agents.

Supported Agents

| Agent | Config File | Logo | |-------|-------------|------| | Cursor | .cursorrules | | | Windsurf | .windsurfrules | | | Claude | CLAUDE.md | |

Install

# Via pnpm (recommended)
pnpm add -g @rblez/crow

# Via npm
npm install -g @rblez/crow

# Via yarn
yarn global add @rblez/crow

Quick Start

# Initialize project
crow init --workspace              # Create .windsurf/ structure + CROW.md

# Install crow library (all skills)
crow add -y                        # Installs all skills + workflows + agent configs

# Install specific skill from GitHub
crow add github.com/user/skill-repo

# Install from local path
crow add /path/to/skill

# List installed skills
crow list                          # or: crow -s

Commands

Core Commands

| Command | Alias | Description | |---------|-------|-------------| | crow init | — | Initialize .windsurf/ structure with CROW.md | | crow add [url] | — | Install skill (default = embedded crow) | | crow remove <name> | — | Remove installed skill | | crow update <name> | — | Update skill | | crow list | ls | List installed skills | | crow doctor | — | Diagnose installation | | crow validate <path> | — | Validate Crow format | | crow --version | -v | Show version with banner |

Namespaces

| Command | Alias | Description | |---------|-------|-------------| | crow skills | crow -s | Manage skills | | crow workflows | crow -w | Manage workflows | | crow global | crow -g | Global configuration |

Multi-Agent Support

The embedded crow skill automatically configures all supported AI agents:

| Agent | Config File | What it does | |-------|-------------|--------------| | Cursor | .cursorrules | Compression + workflows | | Windsurf | .windsurfrules | Compression + workflows | | Claude | CLAUDE.md | Compression + workflows | | VS Code/Copilot | .github/copilot-instructions.md | Compression + workflows |

The Crow Skill

Universal compression mode for AI responses:

| Command | Reduction | Use | |---------|-----------|-----| | /crow | ~65% | Default — balanced | | /crow-lite | ~30% | Light cleanup | | /crow-ultra | ~75% | Maximum density | | /crow-off | — | Return to normal | | /crow-status | — | Show current level |

Workflows:

• /crow-plan — Plan before executing
• /crow-yolo — Execute without confirmations
• /crow-focus — Single task only
• /crow-nerd — Full technical depth
• /crow-commit — Generate commit messages

Project Structure

After crow init:

my-project/
├── .windsurf/              # Windsurf-specific
│   ├── skills/            # Reusable skills
│   │   └── crow/
│   │       ├── SKILL.md
│   │       ├── rules/
│   │       └── agents/
│   ├── workflows/         # Workflow files
│   └── rules/             # Project-level rules
├── .cursorrules           # Cursor config (created by crow add)
├── .clinerules            # Cline config (created by crow add)
├── .windsurfrules         # Windsurf config (created by crow add)
├── CLAUDE.md              # Claude config (created by crow add)
├── GEMINI.md              # Gemini config (created by crow add)
├── .github/
│   └── copilot-instructions.md  # Copilot config (created by crow add)
├── CROW.md                # Project documentation
└── crow-lock.json         # Lock file

Features

• GitHub Integration — Install skills directly from GitHub repos
• Windsurf Symlinks — Auto-link skills to ~/.codeium/windsurf/skills/
• Global Skills — Install once, use everywhere (crow global add)
• Format Validation — Validates SKILL.md presence and structure
• i18n Support — English (default) and Spanish (CROW_LANG=es)
• Minimal UX — Clear status indicators, no noise

Crow Format

Valid Crow skills require:

---
name: skill-name
description: What this skill does
---

## Rules
- Rule 1
- Rule 2

Structure:

• SKILL.md — Metadata and rules (required)
• rules/ — Skill-specific rules (optional)
• agents/ — Agent configs: .cursorrules, CLAUDE.md, etc. (optional)
• workflows/ — Workflow definitions (optional)

Development

# Clone
git clone https://github.com/rblez/crow-cli.git
cd crow-cli

# Install dependencies
pnpm install

# Run locally
pnpm dev
pnpm dev init
pnpm dev add

Contributing

Contributions welcome! Please read our Contributing Guide first.

# Fork and clone
git clone https://github.com/rblez/crow-cli.git
cd crow-cli
pnpm install

# Make changes
pnpm dev validate ./test-skill

# Submit PR

Links

• npm: https://www.npmjs.com/package/@rblez/crow
• Repository: https://github.com/rblez/crow-cli
• Changelog: CHANGELOG.md
• Issues: https://github.com/rblez/crow-cli/issues

Philosophy

Reason well. Talk less. Ship more.

License

MIT © Ray [email protected]