thwip-cli 1.0.0__tar.gz

thwip_cli-1.0.0/.gitignore

@@ -0,0 +1,47 @@
+# Python artifacts
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+env/
+venv/
+ENV/
+
+# Testing & linting
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# Environment & local credentials
+.env
+.env.local
+*.local
+
+# System & editor
+.DS_Store
+.vscode/
+.idea/
+
+# Local context memory
+context.md
+

thwip_cli-1.0.0/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.5
+Name: thwip-cli
+Version: 1.0.0
+Summary: Universal coding agent multiplexer: detect, switch, and route between AI coding agents seamlessly
+Project-URL: Homepage, https://github.com/tanmayhutt/thwip-cli
+Project-URL: Repository, https://github.com/tanmayhutt/thwip-cli
+Author-email: Tanmay <tanmay@users.noreply.github.com>
+License-Expression: MIT
+Keywords: ai,cli,coding-agent,llm,multiplexer
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Requires-Dist: anthropic>=0.40
+Requires-Dist: click>=8.0
+Requires-Dist: google-genai>=1.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: openai>=1.50
+Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: rich>=13.0
+Requires-Dist: tenacity>=9.0
+Requires-Dist: tomli-w>=1.0
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Provides-Extra: all
+Requires-Dist: mistralai>=1.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.7; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# thwip
+
+> Universal Coding Agent Multiplexer
+> 
+> Detect all installed AI coding agents on your device, combine them in a unified terminal interface, and hot-swap models mid-conversation when hitting rate limits without losing context.
+
+---
+
+## 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 between Anthropic Claude, Google Gemini, OpenAI Codex, or local Ollama mid-project. Conversation history and working files transfer directly.
+- **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 in editable mode or via pip:
+
+```bash
+git clone https://github.com/thwip-cli/thwip.git
+cd thwip
+pip install -e .
+```
+
+### 2. Launching thwip
+
+Start the interactive terminal in your current project directory:
+
+```bash
+thwip
+```
+
+---
+
+## Slash Commands and Shortcuts
+
+| Command | Action |
+|:---|:---|
+| `/switch [agent] [model]` | Switch active agent or model mid-conversation |
+| `/agents` | Show all detected coding agents, company status, and capabilities |
+| `/models [agent]` | List available models for current or target agent |
+| `/status` | Display current session, project, and token stats |
+| `/limits` | View token usage, quota, and spend metrics |
+| `/detect` | Re-scan system for newly installed coding agents |
+| `/session save [name]` | Save current chat session |
+| `/session load <name>` | Load a previously saved session |
+| `/session list` | List all saved sessions |
+| `/session clear` | Clear current conversation memory |
+| `/history` | View conversation history with model attribution badges |
+| `/cost` | Show estimated session and cumulative cost |
+| `/project [path]` | View or change project working directory |
+| `Ctrl + S` | Quick switch agent prompt |
+| `Ctrl + T` | Show agent status |
+| `Ctrl + H` | View history |
+| `/quit` | Exit thwip |
+
+---
+
+## Supported Companies and Agents
+
+| Company | Agent | Capabilities |
+|:---|:---|:---|
+| Anthropic | Claude Code (Sonnet, Opus, Haiku) | Chat, File Edit, Code Run, Terminal, Git, Search |
+| Google | Antigravity / Gemini CLI (2.5 Pro, 2.5 Flash) | Chat, File Edit, Code Run, Terminal, Browser, Search |
+| OpenAI | Codex / ChatGPT (GPT-4.1, o3, o4-mini) | Chat, File Edit, Code Run, Terminal |
+| DeepSeek | DeepSeek V3 / R1 Reasoner | Chat, File Edit, Code Run, Reasoning |
+| Groq | Llama 3.3 70B, Mixtral | Chat, File Edit, Code Run |
+| Ollama | Local Models (Llama 3.3, Qwen Coder, DeepSeek R1) | Chat, File Edit, Code Run (Local, Offline) |
+| OpenRouter | Multi-Company Models | Gateway Routing |
+
+---
+
+## 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:
+
+```toml
+[defaults]
+agent = "claude"
+model = "claude-sonnet-4"
+project = "."
+theme = "dark"
+stream = true
+auto_save = 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-sonnet-4",
+    "google/gemini-2.5-pro",
+    "openai/gpt-4.1",
+    "deepseek/deepseek-chat",
+    "ollama/llama3.3"
+]
+```
+
+---
+
+## License
+
+MIT License

thwip_cli-1.0.0/README.md

@@ -0,0 +1,121 @@
+# thwip
+
+> Universal Coding Agent Multiplexer
+> 
+> Detect all installed AI coding agents on your device, combine them in a unified terminal interface, and hot-swap models mid-conversation when hitting rate limits without losing context.
+
+---
+
+## 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 between Anthropic Claude, Google Gemini, OpenAI Codex, or local Ollama mid-project. Conversation history and working files transfer directly.
+- **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 in editable mode or via pip:
+
+```bash
+git clone https://github.com/thwip-cli/thwip.git
+cd thwip
+pip install -e .
+```
+
+### 2. Launching thwip
+
+Start the interactive terminal in your current project directory:
+
+```bash
+thwip
+```
+
+---
+
+## Slash Commands and Shortcuts
+
+| Command | Action |
+|:---|:---|
+| `/switch [agent] [model]` | Switch active agent or model mid-conversation |
+| `/agents` | Show all detected coding agents, company status, and capabilities |
+| `/models [agent]` | List available models for current or target agent |
+| `/status` | Display current session, project, and token stats |
+| `/limits` | View token usage, quota, and spend metrics |
+| `/detect` | Re-scan system for newly installed coding agents |
+| `/session save [name]` | Save current chat session |
+| `/session load <name>` | Load a previously saved session |
+| `/session list` | List all saved sessions |
+| `/session clear` | Clear current conversation memory |
+| `/history` | View conversation history with model attribution badges |
+| `/cost` | Show estimated session and cumulative cost |
+| `/project [path]` | View or change project working directory |
+| `Ctrl + S` | Quick switch agent prompt |
+| `Ctrl + T` | Show agent status |
+| `Ctrl + H` | View history |
+| `/quit` | Exit thwip |
+
+---
+
+## Supported Companies and Agents
+
+| Company | Agent | Capabilities |
+|:---|:---|:---|
+| Anthropic | Claude Code (Sonnet, Opus, Haiku) | Chat, File Edit, Code Run, Terminal, Git, Search |
+| Google | Antigravity / Gemini CLI (2.5 Pro, 2.5 Flash) | Chat, File Edit, Code Run, Terminal, Browser, Search |
+| OpenAI | Codex / ChatGPT (GPT-4.1, o3, o4-mini) | Chat, File Edit, Code Run, Terminal |
+| DeepSeek | DeepSeek V3 / R1 Reasoner | Chat, File Edit, Code Run, Reasoning |
+| Groq | Llama 3.3 70B, Mixtral | Chat, File Edit, Code Run |
+| Ollama | Local Models (Llama 3.3, Qwen Coder, DeepSeek R1) | Chat, File Edit, Code Run (Local, Offline) |
+| OpenRouter | Multi-Company Models | Gateway Routing |
+
+---
+
+## 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:
+
+```toml
+[defaults]
+agent = "claude"
+model = "claude-sonnet-4"
+project = "."
+theme = "dark"
+stream = true
+auto_save = 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-sonnet-4",
+    "google/gemini-2.5-pro",
+    "openai/gpt-4.1",
+    "deepseek/deepseek-chat",
+    "ollama/llama3.3"
+]
+```
+
+---
+
+## License
+
+MIT License

thwip_cli-1.0.0/pyproject.toml

@@ -0,0 +1,64 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "thwip-cli"
+version = "1.0.0"
+description = "Universal coding agent multiplexer: detect, switch, and route between AI coding agents seamlessly"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [
+    { name = "Tanmay", email = "tanmay@users.noreply.github.com" },
+]
+keywords = ["ai", "coding-agent", "cli", "llm", "multiplexer"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+    "rich>=13.0",
+    "prompt-toolkit>=3.0",
+    "httpx>=0.27",
+    "openai>=1.50",
+    "anthropic>=0.40",
+    "google-genai>=1.0",
+    "tomli>=2.0;python_version<'3.11'",
+    "tomli-w>=1.0",
+    "click>=8.0",
+    "tenacity>=9.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.24",
+    "ruff>=0.7",
+]
+all = [
+    "mistralai>=1.0",
+]
+
+[project.scripts]
+thwip = "thwip.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/tanmayhutt/thwip-cli"
+Repository = "https://github.com/tanmayhutt/thwip-cli"
+
+[tool.hatch.build.targets.wheel]
+packages = ["thwip"]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 120
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"

thwip_cli-1.0.0/tests/test_agents.py

@@ -0,0 +1,40 @@
+"""
+Unit tests for agent registry and capabilities.
+"""
+
+from __future__ import annotations
+
+from thwip.agents import AgentRegistry
+from thwip.agents.base import Capability
+
+
+def test_agent_registry_initialization():
+    registry = AgentRegistry()
+    agents = registry.list_agents()
+    assert len(agents) >= 7
+
+    claude = registry.get_agent("claude")
+    assert claude is not None
+    assert claude.company == "Anthropic"
+    assert Capability.FILE_EDIT in claude.capabilities
+
+    google = registry.get_agent("gemini")
+    assert google is not None
+    assert google.company == "Google"
+
+    openai = registry.get_agent("codex")
+    assert openai is not None
+    assert openai.company == "OpenAI"
+
+    ollama = registry.get_agent("ollama")
+    assert ollama is not None
+
+
+def test_capability_comparison():
+    registry = AgentRegistry()
+    claude = registry.get_agent("claude")
+    groq = registry.get_agent("groq")
+
+    # Claude has GIT and BROWSER, Groq might not
+    missing = groq.get_missing_capabilities(claude.capabilities)
+    assert isinstance(missing, list)

thwip_cli-1.0.0/tests/test_detector.py

@@ -0,0 +1,19 @@
+"""
+Unit tests for system detector.
+"""
+
+from __future__ import annotations
+
+from thwip.detector import SystemDetector
+
+
+def test_system_detector_scan():
+    detector = SystemDetector()
+    tools = detector.scan_all()
+    assert isinstance(tools, list)
+    # Ensure tool objects have valid fields
+    for t in tools:
+        assert t.name
+        assert t.company
+        assert t.category
+        assert isinstance(t.capabilities, list)

thwip_cli-1.0.0/tests/test_session.py

@@ -0,0 +1,57 @@
+"""
+Unit tests for thwip session persistence and cross-agent context portability.
+"""
+
+from __future__ import annotations
+
+import tempfile
+from pathlib import Path
+from thwip.session import Session, Message
+
+
+def test_session_message_flow():
+    session = Session(name="test-session")
+    session.add_user_message("Hello from user")
+    session.add_assistant_message("Hello back", agent_name="claude", model="claude-sonnet-4")
+
+    assert len(session.messages) == 2
+    assert session.messages[0].role == "user"
+    assert session.messages[0].content == "Hello from user"
+    assert session.messages[1].role == "assistant"
+    assert session.messages[1].agent_name == "claude"
+
+    # Verify portable representation
+    portable = session.to_portable_messages()
+    assert len(portable) == 2
+    assert portable[0] == {"role": "user", "content": "Hello from user"}
+    assert portable[1] == {"role": "assistant", "content": "Hello back"}
+
+
+def test_session_agent_switching():
+    session = Session(current_agent="claude", current_model="claude-sonnet-4")
+    session.add_user_message("Write a python function")
+    session.add_assistant_message("def hello(): pass", agent_name="claude", model="claude-sonnet-4")
+
+    # Switch agent to google/gemini
+    session.switch_agent("google", "gemini-2.5-pro")
+
+    assert session.current_agent == "google"
+    assert session.current_model == "gemini-2.5-pro"
+    # Context must be fully preserved
+    assert len(session.messages) == 2
+
+
+def test_session_serialization():
+    session = Session(name="serialize-test", project_path="/tmp/test")
+    session.add_user_message("How are you?")
+    session.add_assistant_message("Doing great!", agent_name="openai", model="gpt-4.1")
+
+    saved_path = session.save("serialize-test")
+    assert saved_path.is_file()
+
+    loaded = Session.load("serialize-test")
+    assert loaded is not None
+    assert loaded.name == "serialize-test"
+    assert loaded.project_path == "/tmp/test"
+    assert len(loaded.messages) == 2
+    assert loaded.messages[1].agent_name == "openai"

thwip_cli-1.0.0/tests/test_tools.py

@@ -0,0 +1,40 @@
+"""
+Unit tests for file editor, code runner, and terminal tools.
+"""
+
+from __future__ import annotations
+
+import tempfile
+from pathlib import Path
+from thwip.tools import ToolManager
+
+
+def test_file_editor_operations():
+    with tempfile.TemporaryDirectory() as tmpdir:
+        manager = ToolManager(project_path=tmpdir)
+
+        # 1. Write file
+        res = manager.file_editor.write_file("hello.txt", "line1\nline2\nline3")
+        assert "Successfully wrote" in res
+
+        # 2. Read file
+        content = manager.file_editor.read_file("hello.txt")
+        assert "line1\nline2\nline3" in content
+
+        # 3. Edit file
+        edit_res = manager.file_editor.edit_file("hello.txt", "line2", "line2_updated")
+        assert "Successfully updated" in edit_res
+
+        updated_content = manager.file_editor.read_file("hello.txt")
+        assert "line2_updated" in updated_content
+
+        # 4. List files
+        list_res = manager.file_editor.list_files()
+        assert "hello.txt" in list_res
+
+
+def test_code_runner_python():
+    with tempfile.TemporaryDirectory() as tmpdir:
+        manager = ToolManager(project_path=tmpdir)
+        res = manager.code_runner.run_python("print('Hello from Thwip')")
+        assert "Hello from Thwip" in res

thwip_cli-1.0.0/thwip/__init__.py

@@ -0,0 +1,4 @@
+"""thwip: Universal Coding Agent Multiplexer."""
+
+__version__ = "1.0.0"
+__app_name__ = "thwip"

thwip_cli-1.0.0/thwip/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for `python -m thwip`."""
+
+from thwip.cli import main
+
+if __name__ == "__main__":
+    main()

thwip_cli-1.0.0/thwip/agents/__init__.py

@@ -0,0 +1,98 @@
+"""
+Agent registry and discovery for thwip.
+"""
+
+from __future__ import annotations
+
+from typing import Type
+
+from thwip.agents.base import BaseAgent, Capability, LimitStatus, ModelInfo
+from thwip.agents.claude_agent import ClaudeAgent
+from thwip.agents.google_agent import GoogleAgent
+from thwip.agents.openai_agent import OpenAIAgent
+from thwip.agents.deepseek_agent import DeepSeekAgent
+from thwip.agents.groq_agent import GroqAgent
+from thwip.agents.ollama_agent import OllamaAgent
+from thwip.agents.openrouter_agent import OpenRouterAgent
+from thwip.config import ThwipConfig
+
+# List of all available agent classes in order
+ALL_AGENT_CLASSES: list[Type[BaseAgent]] = [
+    ClaudeAgent,
+    GoogleAgent,
+    OpenAIAgent,
+    DeepSeekAgent,
+    GroqAgent,
+    OllamaAgent,
+    OpenRouterAgent,
+]
+
+
+class AgentRegistry:
+    """Manages instantiated agents and dynamic lookup."""
+
+    def __init__(self, config: ThwipConfig | None = None) -> None:
+        self.config = config or ThwipConfig.load()
+        self._agents: dict[str, BaseAgent] = {}
+        self._initialize_agents()
+
+    def _initialize_agents(self) -> None:
+        """Instantiate all agent adapters with configured keys."""
+        for agent_cls in ALL_AGENT_CLASSES:
+            name = agent_cls.name
+            key = self.config.get_key(name)
+            if name == "google" and not key:
+                key = self.config.get_key("gemini")
+            if name == "claude" and not key:
+                key = self.config.get_key("anthropic")
+            if name == "openai" and not key:
+                key = self.config.get_key("codex")
+
+            if agent_cls is OllamaAgent:
+                inst = OllamaAgent(host=self.config.ollama_host)
+            else:
+                inst = agent_cls(api_key=key)
+
+            self._agents[name] = inst
+
+    def get_agent(self, name: str) -> BaseAgent | None:
+        """Get agent by name or alias."""
+        alias_map = {
+            "claude": "claude",
+            "claude-code": "claude",
+            "anthropic": "claude",
+            "google": "google",
+            "gemini": "google",
+            "antigravity": "google",
+            "agy": "google",
+            "openai": "openai",
+            "codex": "openai",
+            "gpt": "openai",
+            "chatgpt": "openai",
+            "deepseek": "deepseek",
+            "groq": "groq",
+            "ollama": "ollama",
+            "local": "ollama",
+            "openrouter": "openrouter",
+        }
+        normalized = alias_map.get(name.lower().strip(), name.lower().strip())
+        return self._agents.get(normalized)
+
+    def list_agents(self) -> list[BaseAgent]:
+        """Return all instantiated agents."""
+        return list(self._agents.values())
+
+    def get_ready_agents(self) -> list[BaseAgent]:
+        """Return all agents that are installed and configured."""
+        return [
+            a for a in self._agents.values()
+            if a.is_installed() and a.is_configured()
+        ]
+
+    def find_fallback_agent(self, current_agent_name: str) -> BaseAgent | None:
+        """Find the next best ready agent for fallback."""
+        ready = self.get_ready_agents()
+        for a in ready:
+            if a.name != current_agent_name:
+                return a
+        return None