AEQUOR(1)

NAME
aequor - Aequor Cognitive Orchestration Platform CLI

SYNOPSIS
aequor [--help | --version] command [args]

DESCRIPTION
The aequor command provides access to the Aequor Cognitive Orchestration Platform, a universal AI orchestration system that treats AI requests as constraint satisfaction problems.

Aequor provides privacy-preserving intent encoding, semantic caching, continuous learning through shadow logging, and intelligent routing between local and cloud models.

OPTIONS

-h, --help
    Display help for the CLI or a specific command.

-v, --version
    Display the version number.

COMMANDS

query [query]
    Execute a query with intelligent routing. Options:

    -t, --trace
        Show routing trace.

    -b, --backend backend
        Force backend (local/cloud/auto).

    -m, --model model
        Use specific model.

    -f, --format format
        Output format (text/json).

    --no-cache
        Bypass cache.

chat
    Start interactive chat session. Options:

    -b, --backend backend
        Force backend (local/cloud/auto).

    -m, --model model
        Use specific model.

    --no-cache
        Bypass cache.

    --history file
        Load chat history.

status
    Show system status. Options:

    -c, --components
        Show component status.

    -m, --metrics
        Show performance metrics.

    -v, --verbose
        Verbose output.

privacy
    Analyze query privacy and classification. Options:

    -e, --encode
        Generate intent vector.

    --epsilon value
        Privacy parameter for encoding (default: 1.0).

    -d, --detailed
        Show detailed analysis.

    -c, --classify
        Show classification.

    -f, --format format
        Output format (text/json).

cache
    Manage semantic cache. Subcommands:

    stats
        Show cache statistics.

    clear
        Clear cache.

    warm
        Warm cache with common queries.

    invalidate pattern
        Invalidate cache entries by pattern.

cartridge
    Manage knowledge cartridges. Subcommands:

    list
        List installed cartridges.

    install source
        Install a cartridge from file or URL.

    load name
        Load (enable) a cartridge.

    unload name
        Unload (disable) a cartridge.

    create name
        Create a new cartridge.

training
    Training and adapter management. Subcommands:

    shadow
        Show shadow logging status.

    train
        Export training data for ORPO.

    deploy adapter
        Deploy trained adapter.

    rollback
        Rollback to previous adapter version.

    ab-test adapterA adapterB
        Run A/B test between adapters.

system
    System information and management. Subcommands:

    info
        Show system information.

    health
        Check system health.

    metrics
        Show performance metrics.

config
    Manage configuration. Options:

    --list
        List all configuration.

    --get key
        Get configuration value.

    --set key value
        Set configuration value.

    --reset
        Reset to defaults.

models
    List available models. Options:

    -b, --backend backend
        Filter by backend (local/cloud).

    -d, --detailed
        Show detailed information.

cost
    Show cost analysis. Options:

    -p, --period period
        Time period (today/week/month/all).

    -b, --by-backend
        Break down by backend.

test
    Run tests. Options:

    -u, --unit
        Run unit tests only.

    -i, --integration
        Run integration tests only.

    --coverage
        Show coverage report.

EXAMPLES

    # Simple query
    $ aequor query "What is the capital of France?"
    # Interactive chat
    $ aequor chat
    # Check status
    $ aequor status
    # Analyze privacy
    $ aequor privacy "My email is test@example.com"
    # Cache management
    $ aequor cache stats
    $ aequor cache clear
    # List cartridges
    $ aequor cartridge list
    # System health
    $ aequor system health

CONFIGURATION
Configuration is stored in platform-specific locations:

Linux
    ~/.config/aequor/config.json
macOS
    ~/Library/Application Support/Aequor/config.json
Windows
    %APPDATA%\Aequor\config.json

ENVIRONMENT

AEQUOR_CACHE_ENABLED
    Enable/disable caching.

AEQUOR_PRIVACY_EPSILON
    Privacy parameter for intent encoding.

AEQUOR_BACKEND_CLOUD_API_KEY
    OpenAI API key.

AEQUOR_BACKEND_CLOUD_BASE_URL
    Custom base URL for cloud API.

AEQUOR_LOGGING_LEVEL
    Log level (debug/info/warn/error).

EXIT STATUS

SEE ALSO
The full documentation for Aequor is available at: https://github.com/aequor/platform

AUTHORS
Aequor Project

BUGS
Report bugs at: https://github.com/aequor/platform/issues