Remorafish — AI skill for Claude Code

RemoraFish

[Русский](README.ru.md) · [简体中文](README.zh-CN.md)

Agent-first framework for turning your authorized ChatGPT, DeepSeek, Kimi, Grok, and external-provider web sessions into OpenAI-compatible APIs, Anthropic Messages, and MCP tools. It ships a headless runtime, provider SDK, account control plane, built-in reference providers, and a reference web UI.

[!IMPORTANT] **You are solely responsible for your accounts and for every action performed with RemoraFish.** Use it only with accounts and browser profiles that you own or are explicitly authorized to operate. You are responsible for credential security, compliance with provider terms and applicable law, and consequences including account restrictions, suspension, or loss. The project authors do not operate your accounts or guarantee their availability.

RemoraFish v0.2 is a framework preview. It uses web sessions rather than official developer API keys. Providers may change their private protocols or restrict accounts; do not use an account you cannot afford to lose. The public repository contains no user credentials. Browser sessions and token caches are local runtime data stored outside the project tree by default.

Three ways to use RemoraFish

Direction	What you get
Learn	A tested reference architecture for building Web2API adapters and MCP tools over LLM web services
Run	A ready local gateway with account pools, routing, OpenAI/Anthropic surfaces, inference MCP, CLI, and a reference UI
Extend	A versioned provider API, external plugin discovery, scaffold, and conformance suite for building your own infrastructure or fork

The bundled UI is intentionally a **reference application**, not the framework boundary. Agents, API clients, custom frontends, and product forks all use the same headless runtime.

Quick start

1. Install

git clone https://github.com/howdeploy/remorafish.git
cd remorafish
uv sync --extra dev

2. C