Command Line Interface

SwissArmyHammer provides a comprehensive command-line interface for managing prompts, running the MCP server, and integrating with your development workflow.

Installation

# Install from Git repository (requires Rust)
cargo install --git https://github.com/wballard/swissarmyhammer.git swissarmyhammer-cli

# Ensure ~/.cargo/bin is in your PATH
export PATH="$HOME/.cargo/bin:$PATH"

Basic Usage

swissarmyhammer [COMMAND] [OPTIONS]

Global Options

• --help, -h - Display help information
• --version, -V - Display version information

Commands Overview

Quick Examples

Start MCP Server

# Run as MCP server (for Claude Code)
swissarmyhammer serve

Search for Prompts

# Search for code-related prompts
swissarmyhammer search code

# Search with regex in descriptions
swissarmyhammer search --regex "test.*unit" --in description

Test a Prompt

# Interactively test a prompt
swissarmyhammer test code-review

# Test with predefined arguments
swissarmyhammer test code-review --arg code="fn main() { println!(\"Hello\"); }"

Check Setup

# Diagnose any configuration issues
swissarmyhammer doctor

Generate Shell Completions

# Generate Bash completions
swissarmyhammer completion bash > ~/.bash_completion.d/swissarmyhammer

# Generate Zsh completions
swissarmyhammer completion zsh > ~/.zfunc/_swissarmyhammer

Exit Codes

• 0 - Success
• 1 - General error
• 2 - Command line usage error
• 3 - Configuration error
• 4 - Prompt not found
• 5 - Template rendering error

Configuration

SwissArmyHammer looks for prompts in these directories (in order):

1. Built-in prompts (embedded in the binary)
2. User prompts: ~/.swissarmyhammer/prompts/
3. Local prompts: ./.swissarmyhammer/prompts/ (current directory)

For detailed command documentation, see the individual command pages linked in the table above.