APEX runs any LLM in your terminal as a coding agent — Anthropic, OpenAI, Google, Groq, Mistral, DeepSeek, Ollama (local), and 170+ more via litellm. Switch models mid-session. Track costs live. Never leave your terminal.

✨ Why APEX?

🚀 Quick Start

# 1. Set your API key
export ANTHROPIC_API_KEY=sk-ant-...

# 2. Launch APEX (TUI auto-starts)
apex

# 3. Ask anything
> fix the authentication bug in auth.py
> add TypeScript types to all functions
> write tests for the payment module

Switch models / agents anytime:

apex --model gpt-4o            # Start with GPT-4o
apex --model ollama-llama3      # Local, no API key needed
apex --agent architect          # Start in read-only architect mode
apex --continue                 # Resume last session
apex --session mysession        # Load a specific session

🎨 TUI — Terminal User Interface

APEX features a modern terminal UI built with Ink (React for terminals). The TUI connects to the APEX backend via HTTP SSE for real-time token streaming, live cost tracking, and context percentage monitoring.

apex              # Launch TUI (default)
apex --model gpt-4o            # Start with GPT-4o

Keybindings

Features

• 11 Agents: 4 primary (Tab) + 4 subagents (@mention) + 3 system
• 170+ Models: OpenAI, Anthropic, Google, Meta, Mistral, DeepSeek, xAI, etc.
• Live Metrics: Token streaming, per-message cost, total spent, context %
• 12 Themes: apex, nord, catppuccin, tokyonight, gruvbox, matrix, etc.
• Agent Theming: Title bar and status bar change color per agent
• 75+ Tools: File, Code, Shell, Git, Web, Database, Docker, K8s, Security
• MCP/LSP: Server status monitoring
• Leader Keys: Ctrl+X + mnemonic for all actions
• Command Palette: Ctrl+P with fuzzy search
• @ References: Fuzzy file search with @filename
• ! Bash: Run shell commands inline with !command
• HTTP Backend: Local SSE server on port 8080

🎮 Agents

APEX has 11 specialized agents organized by type:

Primary Agents (Tab to cycle)

Subagents (@mention to invoke)

System Agents (automatic, hidden)

Custom agents via Markdown files in .apex/agents/*.md or ~/.config/apex/agents/*.md.

📋 CLI Commands

apex                          # Launch TUI (default)
apex run <prompt>             # Non-interactive mode
apex serve                    # Start headless HTTP API server
apex web                      # Server + web interface
apex gateway start            # Start APEX Gateway (proxy + auth + rate limits)
apex gateway key <tier>       # Generate a gateway API key
apex gateway status           # Show gateway keys and usage
apex auth login               # Interactive provider login
apex auth list                # List configured providers
apex auth logout              # Remove provider config
apex agent create             # Interactive agent wizard
apex agent list               # List all agents
apex session list             # List sessions
apex session delete <id>      # Delete a session
apex stats                    # Token usage & cost stats
apex export <id>              # Export session as JSON
apex import <file|url>        # Import session
apex upgrade                  # Upgrade APEX
apex uninstall                # Remove APEX
apex mcp add                  # Add MCP server
apex mcp list                 # List MCP servers
apex mcp auth <name>          # Authenticate MCP server
apex db path                  # Show database path
apex pr <number>              # Fetch & checkout PR
apex attach <url>             # Attach to remote backend
apex connect                  # Interactive provider config
apex init                     # Initialize project
apex compact                  # Compact context
apex details                  # Toggle tool output
apex thinking                 # Toggle reasoning blocks
apex models [provider]        # List models
apex --model <name>           # Set model
apex --agent <name>           # Set agent
apex --continue               # Resume last session

🔧 Configuration

APEX uses hierarchical JSON/JSONC config (like OpenCode):

# Global config
~/.config/apex/apex.json       # Main config
~/.config/apex/tui.json        # TUI-specific config

# Project config (overrides global)
./apex.json
./apex.jsonc

# Env vars (inline override)
APEX_CONFIG=./custom.json
APEX_CONFIG_CONTENT='{"model": "gpt-4o"}'

apex.json schema

{
  "$schema": "https://apex-ai.dev/config.json",
  "model": "claude-sonnet-4-5",
  "theme": "nord",
  "agent": {
    "code-reviewer": {
      "description": "Reviews code for best practices",
      "mode": "subagent",
      "permission": { "edit": "deny" }
    }
  },
  "command": {
    "test": {
      "template": "Run tests with coverage",
      "description": "Run tests"
    }
  },
  "permission": { "edit": "ask", "bash": "ask" },
  "formatter": true,
  "lsp": true,
  "share": "manual",
  "snapshot": true,
  "server": { "port": 8080, "hostname": "127.0.0.1" },
  "watcher": {
    "ignore": ["**/node_modules/**", "**/.git/**"]
  }
}

Variables in config

{
  "model": "{env:APEX_MODEL}",
  "provider": {
    "anthropic": { "apiKey": "{file:~/.secrets/anthropic-key}" }
  }
}

🛠️ What APEX Can Do

• Read & edit files — understands your whole codebase
• Run commands — tests, builds, installs, git
• Search code — grep-style across your project
• 11 agents — specialized for different tasks
• Subagents — invoke via @mention for parallel tasks
• Custom commands — define via .apex/commands/*.md
• Auto-formatting — ruff, prettier, gofmt, rustfmt, etc.
• File watching — configurable ignore patterns
• Session sharing — public URLs for collaboration
• Fix bugs — diagnoses, patches, and verifies
• Write features — complete implementations
• Refactor code — preserves your style
• Write tests — pytest, jest, go test, and more
• Explain code — line by line if needed

🎭 Themes

12 built-in themes with dark/light mode support:

apex          ayu           catppuccin    catppuccin-macchiato
everforest    gruvbox       kanagawa      matrix
nord          one-dark      system        tokyonight

# Via TUI
Ctrl+X T         # Theme selector

# Via config
echo '{"theme": "nord"}' > ~/.config/apex/tui.json

Custom themes in ~/.config/apex/themes/*.json or .apex/themes/*.json.

🔗 Session Sharing

Share conversations with your team:

/share          # Create shareable URL → https://apex-ai.dev/s/abc123
/unshare        # Remove shared session

Modes: manual (default) | auto | disabled (set in config)

🎨 Formatters

Auto-formatting support for 11 languages:

Python:     ruff
JS/TS/JSON: prettier
Rust:       rustfmt
Go:         gofmt
Java:       google-java-format
C/C++:      clang-format
Ruby:       rubocop
Scala:      scalafmt
Kotlin:     ktlint
Swift:      swift-format
Zig:        zig fmt

# Enable all formatters
echo '{"formatter": true}' > apex.json

# Per-formatter config
echo '{"formatter": {"prettier": {"disabled": true}}}' > apex.json

🔒 Security

APEX includes comprehensive security features:

Shell Command Analysis

Blocks dangerous patterns: rm -rf /, curl | sh, fork bombs, disk writes.

Permission System

Fine-grained ALLOW/DENY/ASK per tool with glob pattern support.

Rate Limiting & API Keys

Database-backed rate limiting with workspace-based API keys.

HTTP API Security

Bearer token auth on all endpoints, configurable via config.

⚡ Installation

One-line install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/Ggboykxz/APEX/main/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/Ggboykxz/APEX/main/install.ps1 | iex

Package managers

From source

git clone https://github.com/Ggboykxz/APEX
cd APEX
pip install -e ".[dev]"

⚡ APEX Gateway (Zero-Config Free Models)

APEX Gateway is a built-in proxy server that gives you access to free + paid models without configuring API keys.

# 1. Get your free OpenRouter API key
#    → https://openrouter.ai/keys (no credit card needed)

# 2. Add it to .env
echo "OPENROUTER_API_KEY=sk-or-v1-..." >> .env

# 3. Start the gateway
apex gateway start
# → Gateway running on http://127.0.0.1:9090

# 4. Generate user keys
apex gateway key free "alice"      # Free tier: 50 req/day
apex gateway key pro "bob"         # Pro tier: 500 req/day

Tiers

API

# Register a new user
curl -X POST http://127.0.0.1:9090/v1/register \
  -H "Content-Type: application/json" \
  -d '{"tier": "free", "label": "new-user"}'

# Chat via gateway
curl -X POST http://127.0.0.1:9090/v1/chat/completions \
  -H "Authorization: Bearer apex_..." \
  -H "Content-Type: application/json" \
  -d '{"model": "free-or-qwen3-coder", "messages": [{"role": "user", "content": "Hello"}]}'

# Check usage
curl -H "Authorization: Bearer apex_..." http://127.0.0.1:9090/v1/status

🤖 Supported Models (170+)

Bring Your Own Key (BYOK)

Use your own API keys from any provider:

export ANTHROPIC_API_KEY=sk-ant-...
apex --model claude-sonnet-4-5   # Recommended
apex --model claude-opus-4-5     # Most powerful
apex --model claude-haiku-4-5    # Fastest
apex --model claude-sonnet-4-6   # Latest
apex --model claude-opus-4-7     # Most advanced

export OPENAI_API_KEY=sk-...
apex --model gpt-4o
apex --model gpt-4o-mini
apex --model gpt-5
apex --model o3
apex --model o4-mini

export GEMINI_API_KEY=...
apex --model gemini-2.5-pro
apex --model gemini-2.5-flash
apex --model gemini-3-flash
apex --model gemma-4-31b

export GROQ_API_KEY=gsk_...
apex --model llama-groq-4-maverick
apex --model mixtral-groq-8x7b
apex --model qwq-groq-32b

ollama pull llama3
apex --model ollama-llama3
apex --model ollama-deepseek-r1
apex --model ollama-qwen2.5-coder

export DEEPSEEK_API_KEY=...
apex --model deepseek-chat
apex --model deepseek-reasoner
apex --model deepseek-v4-flash
apex --model deepseek-v4-pro

💖 Sponsors

APEX is free and open source. If it saves you time, consider sponsoring.

🤝 Contributing

git clone https://github.com/Ggboykxz/APEX
cd APEX
pip install -e ".[dev]"
pytest

Customize with commands in .apex/commands/*.md, agents in .apex/agents/*.md, and themes in .apex/themes/*.json.

See CONTRIBUTING.md for guidelines.

📄 License

Proprietary — All rights reserved by Ggboykxz.

See LICENSE for full terms.