Slash Commands

Slash Commands provide a quick, shorthand way to invoke specific actions or context-gathering scripts. Unlike Skills (which are broad capabilities), Commands are typically focused, single-purpose scripts.

Creating a Command

Initialize a new command with aix command init.

aix command init /deploy

This creates a markdown file (e.g., deploy.md) with the command definition.

Command Format

---
name: deploy
description: Deploy the application to a specific environment
arguments:
  - name: environment
    description: Target environment (staging | production)
    required: true
---

# Deployment Instruction

Please deploy the current codebase to the **$ARGUMENTS** environment.
Use the `scripts/deploy.sh` script.

Variables

aix handles variable interpolation across platforms.

  • $ARGUMENTS: The text typed after the command (e.g., /deploy staging -> staging).
  • $SELECTION: The currently selected code in the editor (if supported).

Installing Commands

From a Repository

The easiest way to install commands is from a configured repository.

aix command install deploy

From a Local File

You can also install commands directly from a markdown file.

aix command install ./deploy.md

aix will translate this into:

  • Claude Code: A custom slash command file.
  • Gemini CLI: A command entry in .gemini/commands/.
  • OpenCode: A command entry in the agent configuration.

Managing Commands

Listing

aix command list

Removing

aix command remove /deploy

When to use Commands vs. Skills?

FeatureCommandsSkills
ScopeSingle action or promptBroad capability / workflow
ComplexityLowHigh
ToolsUsually relies on existing toolsCan bundle its own tools
Example/fix-lintGit Workflow