For AI agents: the complete documentation index is available at https://aioproxy.dev/llms.txt, the full documentation bundle is available at https://aioproxy.dev/llms-full.txt, and this page is available as Markdown at https://aioproxy.dev/guide/reference/cli.md.
  • English
  • CLI Reference

    The aio-proxy command-line interface provides comprehensive controls for running, configuring, and maintaining the proxy.

    Alias

    The shortcut command aiop is identical to aio-proxy.


    Command Overview

    CommandDescription
    runStart the HTTP proxy server and Dashboard
    configManage, edit, validate, and print configuration
    reloadSend a hot-reload signal to the running daemon
    oauthLog in and manage OAuth subscription accounts
    agentConfigure native coding agents (Codex, Grok, OpenCode, Pi, OMP)
    serviceManage background OS daemons (launchd / systemd)
    upgradeSelf-upgrade CLI binary to the latest release

    Command Reference

    aio-proxy run

    aio-proxy run [options]
    • --open: Open Dashboard in default browser upon startup.
    • --port <number>: Override port (default 9317).
    • --host <ip>: Bind address (default 127.0.0.1; use 0.0.0.0 for Docker).
    • --config <path>: Custom configuration file path.

    aio-proxy config

    aio-proxy config edit       # Open config in default editor
    aio-proxy config validate   # Check syntax and schema
    aio-proxy config print      # Print active configuration
    aio-proxy reload            # Hot-reload running server

    aio-proxy oauth

    aio-proxy oauth login <provider-id>   # Launch browser login
    aio-proxy oauth status                # Inspect token validity

    aio-proxy agent

    aio-proxy agent configure <codex|claude-code|grok|opencode|pi|omp>
    aio-proxy agent list [--check]
    aio-proxy agent remove <target>
    aio-proxy agent revoke <installation-id>

    aio-proxy service

    aio-proxy service install     # Register system daemon
    aio-proxy service start       # Start background daemon
    aio-proxy service status      # View daemon status
    aio-proxy service stop        # Stop background daemon
    aio-proxy service uninstall   # Unregister system daemon