AI Expert CLI

A command-line tool to manage and query specialized Claude assistants. Create domain-specific AI experts with custom knowledge bases.

Prerequisites

• Node.js 14.0 or higher
• Claude CLI installed and configured

Installation

npm install -g ai-expert-cli
# or
pnpm add -g ai-expert-cli

Quick Start

# Create a new expert
ai create "React Expert" "React.js development with hooks and performance optimization"

# Quick query (returns answer and exits)
ai react-expert "how to optimize re-renders?"

# Interactive mode (continuous conversation)
ai react-expert

# Interactive with initial question
ai react-expert -i "how to optimize re-renders?"

# List all experts
ai list

Usage

Creating Experts

ai create <name> <specialty>

Creates a new AI expert with specified knowledge domain. Experts are stored in ~/.ai-experts/.

Querying Experts

# Quick answer mode
ai <expert-name> "your question"

# Interactive conversation mode
ai <expert-name>
ai <expert-name> -i
ai <expert-name> --interactive "initial question"

Get instant answers or start an interactive conversation with your specialized assistants.

Managing Experts

# List all available experts
ai list

# Edit an expert's configuration
ai edit <expert-name>

Expert Configuration

Each expert is a JSON file in ~/.ai-experts/ with the following structure:

{
  "name": "Expert Name",
  "slug": "expert-name",
  "specialty": "Domain expertise description",
  "systemPrompt": "Custom instructions for the AI",
  "context": {
    "concepts": ["key concept 1", "key concept 2"],
    "patterns": ["best practice 1", "best practice 2"],
    "examples": [
      {
        "name": "Example name",
        "code": "example code"
      }
    ],
    "customVariables": {}
  }
}

Examples

Create a Tailwind CSS Expert

ai create "Tailwind Master" "Tailwind CSS with custom design systems"

Create a Database Expert

ai create "DB Architect" "PostgreSQL optimization and schema design"

Query for Specific Solutions

ai tailwind-master "create a gradient button with hover effect"
ai db-architect "optimize query with multiple joins"

# Interactive mode
ai tailwind-master
ai db-architect -i "explain indexing strategies"

Features

• 🚀 Fast: Direct integration with Claude CLI for instant responses
• 🎯 Specialized: Create experts for any domain or technology
• 📚 Knowledge Base: Store patterns, examples, and best practices
• 🔧 Customizable: Edit expert configurations anytime
• 💡 Smart: Leverages Claude's capabilities with focused expertise
• 💬 Interactive: Start conversations with experts using -i flag
• ⚡ Dual Commands: Use both ai and ai-expert commands

How It Works

1. Expert Creation: Define a specialist with domain knowledge
2. Context Building: Add concepts, patterns, and examples
3. Query Processing: Combines system prompt with your question
4. Claude Integration: Uses local Claude CLI for processing
5. Instant Response: Get expert-level answers immediately

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Author

Anderson Denis da Rosa

License

MIT

Note: This tool requires Claude CLI to be installed and accessible in your PATH.