# Raxol

> Multi-surface runtime for Elixir on OTP. One TEA module renders to terminal, browser (LiveView), SSH, MCP, Telegram, and watch surfaces.

## Quick start

    ssh -p 2222 playground@raxol.io    # zero install
    {:raxol, "~> 2.4"}                 # add to mix.exs

## Capability summary

Raxol is an Elixir framework built on OTP. It uses The Elm Architecture (TEA): init/1, update/2, view/1. The same module renders to six surfaces without modification.

Surfaces: terminal (termbox2 NIF), browser (Phoenix LiveView), SSH (Erlang :ssh), MCP (stdio JSON-RPC), Telegram (per-chat sessions), watch (APNS/FCM push).

Agent framework: TEA agents (message-driven) and Process agents (tick-driven). Teams with coordinator/worker supervision. Strategies: Direct (sequential) and ReAct (LLM reasoning loop). Backends: Anthropic, OpenAI, Ollama, Groq, Kimi, Lumo, Mock.

Agent payments: x402 (HTTP 402 micropayments), MPP (Stripe/Tempo), Xochi (cross-chain intent settlement with stealth addresses). SpendingPolicy + Ledger for per-request/session/lifetime limits.

MCP tools: auto-derived from widget tree via ToolProvider behaviour. Built-in headless tools: raxol_start, raxol_screenshot, raxol_send_key, raxol_get_model, raxol_stop, raxol_list.

OTP gives: crash isolation per component, hot code reload, distributed clustering (CRDTs, gossip/DNS/Tailscale discovery), time-travel debugging.

## Structured endpoints

- Skill file: https://raxol.io/skill.md
- Capability manifest: https://raxol.io/.well-known/raxol.json
- Capabilities API: https://raxol.io/api/capabilities
- Docs: https://hexdocs.pm/raxol
- GitHub: https://github.com/DROOdotFOO/raxol
- Hex: https://hex.pm/packages/raxol

## MCP integration

    {
      "mcpServers": {
        "raxol": {
          "command": "mix",
          "args": ["mcp.server"],
          "cwd": "/path/to/your/raxol/app"
        }
      }
    }

## Packages

- raxol -- Full framework: TEA runtime, rendering, widgets, effects
- raxol_agent -- AI agents, teams, strategies, LLM streaming
- raxol_mcp -- MCP server, tool derivation from widgets
- raxol_payments -- x402, MPP, Xochi cross-chain, spending controls
- raxol_liveview -- LiveView bridge, TerminalBridge, TEALive
- raxol_sensor -- Sensor fusion (zero dependencies)
- raxol_terminal -- VT100/ANSI emulation, screen buffer, termbox2 NIF
- raxol_core -- Behaviours, events, config, accessibility, plugins
- raxol_plugin -- Plugin SDK, generator, testing utils
- raxol_speech -- TTS/STT, voice commands
- raxol_telegram -- Telegram bot surface
- raxol_watch -- APNS/FCM push notifications
