JSPM

  • Created
  • Published
  • Downloads 282
  • Score
    100M100P100Q102638F
  • License SEE LICENSE IN LICENSE

AI-powered CLI assistant for terminal productivity

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 (@aiiware/aii) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    @aiiware/aii

    AI-powered CLI assistant that brings intelligent AI capabilities directly to your terminal.

    Installation

    Install globally to use the aii command anywhere:

    npm install -g @aiiware/aii

    Requirements

    • Node.js 18+
    • Aii Server running (default: localhost:26169)

    Quick Start

    # First run - auto-initializes configuration
    aii "explain what git rebase does"
    
    # Pipe content for processing
    cat error.log | aii "summarize the errors"
    
    # Interactive chat mode
    aii chat
    
    # Clean output (just the result)
    aii "translate hello to spanish" --clean
    
    # Use a specific model
    aii "complex analysis" --model gpt-4o

    Commands

    AI Query (default)

    aii "your question"
    aii "your question" --clean        # Just the result
    aii "your question" --standard     # Result + metrics (default)
    aii "your question" --thinking     # Full reasoning

    Interactive Chat

    aii chat                           # Start interactive chat session
    
    # In chat mode:
    /help          # Show available commands
    /clear         # Clear conversation and start fresh
    /history       # Show conversation history
    /stats         # Show session statistics
    /exit          # Exit chat mode

    Prompts (Templates)

    aii prompt list                    # List available prompts
    aii prompt show <name>             # Show prompt details
    aii prompt use <name> [--var value]  # Use a prompt template

    Configuration

    aii config show                    # Show current configuration
    aii config validate                # Validate configuration
    aii config set <key> <value>       # Set a configuration value
    aii config model <model>           # Change LLM model
    aii config provider <provider>     # Change LLM provider

    System

    aii doctor                         # System health check
    aii --help                         # Show help
    aii --version                      # Show version

    Options

    Option Description
    --clean Clean output mode (just the result)
    --standard Standard output mode (result + metrics)
    --thinking Thinking mode (full reasoning)
    --model <model> Override LLM model
    --host <host:port> API server host
    -y, --yes Auto-confirm shell commands
    --offline Offline mode (no web/MCP)
    --no-colors Disable colored output
    --no-emojis Disable emoji icons
    --no-streaming Disable streaming output

    Configuration

    Configuration is stored in ~/.aii/:

    • config.yaml - Main configuration
    • secrets.yaml - API keys

    Example config.yaml

    llm:
      provider: deepseek
      model: deepseek-chat
      temperature: 0.7
    
    api:
      url: http://localhost:26169

    API Keys

    Store your LLM provider API keys in ~/.aii/secrets.yaml:

    anthropic_api_key: sk-ant-...
    openai_api_key: sk-...
    deepseek_api_key: sk-...

    Or set via environment variables:

    • ANTHROPIC_API_KEY
    • OPENAI_API_KEY
    • DEEPSEEK_API_KEY

    Features

    • Real-time Streaming: Token-by-token response display
    • Interactive Chat: Multi-turn conversations with context
    • Prompt Templates: Pre-built templates for common tasks
    • Multiple LLM Providers: Claude, GPT, Gemini, DeepSeek, and more
    • Pipe Support: Process piped content with AI
    • Output Modes: Clean, standard, or thinking mode

    License

    Proprietary - Copyright 2025-present AiiWare.com. All Rights Reserved.