Typed public surface for the moxxy framework: event types, define* factories, lifecycle hook signatures.

Moxxy is a mock and a proxy for developing against APIs that may or may not exist.

Batteries-included entry to moxxy: one install + one call to run an agent. Bundles @moxxy/core, the default loop, and the OpenAI + Anthropic providers behind drop-in presets — `setupAgent(openaiPreset({ apiKey }))`.

moxxy command-line agent: TUI, one-shot prompts, setup, services, and API-key or installed-CLI subscription providers.

OpenAI (and OpenAI-compatible: z.ai, xAI, Google, Ollama/local) LLMProvider plugin for moxxy. Streams Chat Completions with tool_calls; translates moxxy ProviderRequest/Event ↔ the OpenAI wire shape. Register it into an @moxxy/core Session to route turns

Anthropic (Claude) LLMProvider plugin for moxxy. Streams the Messages API with tool use + adaptive thinking; translates moxxy ProviderRequest/Event ↔ the Anthropic wire shape. Register it into an @moxxy/core Session to route turns to Claude models.

Web capabilities for moxxy: pluggable web_search fallback, web_fetch, and a Playwright browser_session sidecar.

Internal Companion framework package. Modules import @moxxy/companion-sdk instead.

Default loop strategy (mode) for moxxy — a Claude Code-style ReAct tool-use loop. Register it into an @moxxy/core Session to give your agent its turn-by-turn reasoning + tool-calling behaviour.

Companion runner agent — execute Companion's AI agent work (moxxy gateways, git worktrees, PRs) on any machine, driven by a companiond over HTTP+WebSocket.

Internal Companion framework package. Modules import @moxxy/companion-sdk instead.

Internal Companion framework package. Modules import @moxxy/companion-sdk instead.

The moxxy runtime as a programmatic library: the agentic Session + runTurn loop, the event log, the plugin host, every block registry (providers, tools, modes, compactors, cache strategies, channels, …), session persistence, and the permission engine. Pai

Journal-based long-term memory for moxxy. Markdown files at ~/.moxxy/memory/ with type/description frontmatter + an index. Plus STM selectors over the event log.

Internal Companion framework package. Modules import @moxxy/companion-sdk instead.

OpenAI Codex OAuth speech-to-text transcriber (Whisper family) for moxxy.

xAI (Grok) LLMProvider plugin for moxxy. Streams the OpenAI-compatible xAI API (https://api.x.ai/v1).

MCP (Model Context Protocol) client plugin for moxxy — connect to MCP servers and surface their tools.

Self-hosted tunnel provider for moxxy. Dials the proxy relay over an outbound control WebSocket, proves ownership of a keypair-derived subdomain (uuid.proxy.moxxy.ai), and pipes each inbound connection to a local port — a native-Node replacement for the c

Google Gemini LLMProvider plugin for moxxy. Streams the Gemini OpenAI-compatible endpoint (generativelanguage.googleapis.com/v1beta/openai).