Documentation

Commands

Commands are custom slash commands that appear in Claude Code. Create reusable prompts with optional arguments to streamline your workflow and ensure consistent AI interactions.

Overview

Commands let you define reusable prompts that can be triggered using slash notation (e.g., /review, /security-check). When you invoke a command, its content is sent to the AI along with any arguments you provide.

Key features include:

  • Slash notation — Trigger commands with /command-name in your IDE
  • Arguments — Define up to 3 optional or required arguments per command
  • Reusable prompts — Write once, use everywhere across your workspace
  • Import/Export — Share commands as JSON files

Versioning, experimental & sharing

Commands are versioned. A release snapshots the command's body and its arguments together as an immutable version, and Claude Code is served the command's stable release — not your live draft. A command with no promoted release is skipped entirely; there is no fallback to the draft. Because the slash command's argument hint and its executed body both come from the same release, the hint a user sees always matches the body that runs. An experimental session can serve a flagged command's live draft instead, and you can share a command's released snapshot via an unlisted link.

Creating a Command

To create a new command:

  1. Navigate to your workspace
  2. Click the Commands tab
  3. Click New Command
  4. Fill in the command details:
    • Name — The command name in kebab-case (e.g., security-review)
    • Description — A brief description of what the command does
    • Content — The prompt text sent to the AI when the command is invoked
  5. Click Create

Command Arguments

Commands can have up to 3 arguments that users provide when invoking the command. Arguments make your commands more flexible and reusable.

Adding Arguments

  1. Open an existing command or create a new one
  2. Click Arguments in the command card menu
  3. Click Add Argument
  4. Configure the argument:
    • Name — Argument name in kebab-case (e.g., file-path)
    • Description — Help text shown to users
    • Required — Whether the argument must be provided
  5. Save the argument

Argument Limits

Limitation Limit
Arguments per command 3
Argument name length 30 characters
Argument description length 100 characters

Using Commands

Once a command has a stable release, it's available as a native slash command in Claude Code — the superclawd launcher loads your released commands automatically at the start of each session. A command with no promoted release is skipped (no fallback to the draft); see Versioning, experimental & sharing below.

In Claude Code

Type / to see your commands, then invoke one by name. Claude receives the command content along with any arguments you provide.

Example Command

A command named security-review with content "Review the following code for security vulnerabilities..." would be invoked as /security-review in Claude Code.

Enabling & Disabling Commands

Commands can be enabled or disabled:

  1. Open the command card menu (three dots)
  2. Click Enable or Disable
  3. Disabled commands appear dimmed and won't be available in your IDE

Favorites

Mark frequently used commands as favorites for quick access:

  1. Go to the Commands page
  2. Find the command you want to favorite
  3. Click the star icon on the command card

Favorited commands appear at the top of your commands list, making them easy to find. Click the star icon again to remove a command from your favorites.

Personal favorites

Favorites are personal to your account. Other workspace members won't see your favorites, and you won't see theirs.

Exporting Commands

Commands can be exported as JSON files for backup or sharing:

  1. Open the command card menu (three dots)
  2. Click Export as JSON
  3. The command with all its arguments will be downloaded as a JSON file

The exported JSON format:

json
{
  "name": "security-review",
  "description": "Perform a security review of the code",
  "content": "Review the following code for security vulnerabilities...",
  "arguments": [
    {
      "name": "focus-area",
      "description": "Specific area to focus on",
      "required": false
    }
  ]
}

Importing Commands

Import commands from JSON files:

  1. Click the Import button next to "New Command"
  2. Drag and drop a JSON file or click to browse
  3. The system validates the JSON structure
  4. Preview shows command name, description, and argument count
  5. Click Import Command to create it

Note: If a command with the same name exists, it will be auto-renamed (e.g., "review" → "review-2").

Community Commands

Don't want to start from scratch? Browse ready-to-use commands created by the community:

Community Repository

Visit github.com/superclawd-ai/superclawd/commands to discover command examples for code review, security audits, documentation, and more. Download JSON files and import them directly into your workspace.

Contributing Your Commands

Have commands that work well for your team? Share them with the community:

  1. Export your command as JSON
  2. Fork the community repository
  3. Add your command to commands/examples/
  4. Submit a pull request

See the Contributing Guide for detailed instructions.

Content Limits

Commands have the following content limits:

Field Limit
Name 30 characters
Description 200 characters
Content 5,000 characters

Pricing

Commands are charged each time they are invoked in Claude Code.

Free tier

Free billing accounts are not charged for commands. See Billing Account Tiers for more information.

Item Cost
Per command invocation 0.25 credits

See Billing & Credits for more details on credit management and purchasing.

Workspace Limits

The number of commands per workspace depends on your billing account tier. See Workspace Item Limits for details.