Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ai-expert) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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

Expert Creation: Define a specialist with domain knowledge
Context Building: Add concepts, patterns, and examples
Query Processing: Combines system prompt with your question
Claude Integration: Uses local Claude CLI for processing
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.