thwip

Universal Coding Agent Multiplexer

Discover supported local AI tools, connect configured model providers in one terminal interface, and switch providers while preserving completed text conversation history.

Features

• Auto-Detection: Discovers installed AI coding agents (Claude Code, Antigravity, Gemini CLI, OpenAI/Codex, Aider, Copilot, Cursor, Windsurf, Cline, Ollama) and configured credentials.
• Context Portability: Switch providers with stored conversational text. Working files remain in the selected local project; they are not automatically uploaded.
• Handoff Preview: Inspect text continuity, omitted state, capability changes, approximate context pressure, and a text fingerprint before switching. Runs locally without model calls.
• Dynamic UI: Terminal interface adapts its status bar, capabilities, and theme based on the active provider.
• Capability Disclaimers: Highlights when an agent lacks specific capabilities such as file editing or code execution.
• Rate Limit Failover: Detects HTTP 429 errors or quota exhaustion and prompts instant switching to ready fallback models.
• Tool Layer: Shared file editing, code execution (Python, Node, Shell), and Git integration across connected models.
• Session Persistence: Save and resume sessions across projects with /session save and /session load.
• Terminal Ergonomics: Autocompletion (Tab), keyboard shortcuts (Ctrl+S, Ctrl+T, Ctrl+H), and streaming markdown rendering.

Quickstart

1. Installation

Install the published package:

pip install --upgrade thwip-cli

Or install the repository in editable mode for development:

git clone https://github.com/tanmayhutt/thwip-cli.git
cd thwip-cli
pip install -e .

2. Launching thwip

Start the interactive terminal in your current project directory:

thwip

Slash Commands and Shortcuts

Short aliases are available for frequent commands: /a, /m, /s, /k, /g, and /t. | Ctrl + T | Show agent status | | Ctrl + H | View history | | /quit | Exit thwip |

Auditable handoffs

/handoff
/handoff google
/handoff openai gpt-5.6-terra

/handoff previews the current target; specifying a provider uses its default model unless you supply a model ID. Targets can be inspected without credentials or an installed provider. /switch shows the same report before changing the active agent.

The report includes:

• Exact counts of transferred user/assistant text messages and excluded stored records.
• A count of observed transient tool results that are not in portable history. New sessions track from creation; older saved sessions explicitly report partial coverage.
• Capability gains and losses using the local model catalog.
• Approximate request size including tool schemas, with up to 4,096 tokens reserved for an answer in the advisory calculation. This does not change generation settings.
• SHA-256 of canonical system-prompt and conversational-text JSON. It stays the same across targets when that text is unchanged. Tool schemas and attribution metadata are intentionally outside this text fingerprint.

The preview makes no model requests, saves no transcript exports, executes no tools, and does not trim or summarize history. Token sizing uses UTF-8 bytes divided by four plus per-message overhead, not a provider tokenizer. Catalog limits can be stale; an apparently fitting request can still fail. Warnings are advisory, not switch gates. Hidden reasoning and provider-native state do not transfer. The digest proves neither delivery nor semantic understanding, and is not a signature or privacy guarantee.

See research and prior art for the differentiation rationale.

Supported Companies and Agents

Configuration (~/.thwip/config.toml)

thwip auto-detects existing API keys from environment variables and existing agent configs (~/.claude.json, ~/.gemini/config.json). Configuration can also be set manually:

Installed apps, CLI sign-ins, and API access are separate. thwip can report a detected Claude, Gemini, or Codex CLI login, but the current SDK adapters require a provider API key. A ChatGPT, Claude, or Google subscription does not automatically provide a reusable third-party API key. Ollama needs no key when its local server is running.

[defaults]
agent = "claude"
model = "claude-opus-5"
project = "."
theme = "dark"
stream = true
auto_save = true
confirm_tools = true

[keys]
anthropic = "sk-ant-..."
google = "AIza..."
openai = "sk-..."
deepseek = "sk-..."
groq = "gsk_..."
openrouter = "sk-or-..."

[ollama]
host = "http://localhost:11434"

[fallback]
enabled = true
chain = [
    "claude/claude-opus-5",
    "google/gemini-3.7-flash",
    "openai/gpt-5.6-terra",
    "deepseek/deepseek-v4-flash",
    "ollama/llama3.3"
]

Prefer /key <provider> over editing the file directly. Mutating workspace tools ask for confirmation by default, file access is restricted to the selected project, and Thwip stores its config and saved sessions with user-only permissions.

License

MIT License