@lioneltay/claude-pilot 0.1.0

package/README.md

@@ -0,0 +1,197 @@
+# Claude Pilot
+
+Run [Claude Code](https://docs.anthropic.com/en/docs/claude-code) through GitHub Copilot's API.
+
+## Prerequisites
+
+### 1. GitHub Copilot Subscription
+
+You need an active GitHub Copilot subscription (Individual, Business, or Enterprise).
+
+### 2. Copilot CLI
+
+Install the GitHub Copilot CLI:
+
+```bash
+npm install -g @github/copilot
+
+# Verify installation
+copilot --version
+```
+
+### 3. Claude Code
+
+Install the Claude Code CLI:
+
+```bash
+curl -fsSL https://claude.ai/install.sh | bash
+
+# Verify installation
+claude --version
+```
+
+See [Claude Code setup docs](https://code.claude.com/docs/en/setup) for more details.
+
+## Installation
+
+```bash
+npm install -g @lioneltay/claude-pilot
+```
+
+## Quick Start
+
+```bash
+# 1. Authenticate with GitHub Copilot
+claude-pilot login
+
+# 2. Run Claude Code (proxy starts automatically)
+claude-pilot
+```
+
+## Features
+
+- **Web Search** - Works via Copilot CLI at no extra cost
+- **Cost Optimization** - Tool continuations are free, only new user messages are charged (~$0.04)
+- **Free Suggestions** - Autocomplete requests routed to GPT-4.1 (free model)
+- **Auto Token Refresh** - Copilot tokens refresh automatically before expiry
+- **Dashboard** - Web-based log viewer at `http://localhost:51080/`
+- **Zero Config** - Proxy auto-starts and finds an available port
+
+## Commands
+
+### `claude-pilot`
+
+Run Claude Code with the proxy. If no arguments are provided, launches Claude Code interactively. Any arguments are passed through to Claude.
+
+```bash
+# Interactive mode
+claude-pilot
+
+# Pass arguments to claude
+claude-pilot --help
+claude-pilot "explain this codebase"
+```
+
+The proxy starts automatically if not already running.
+
+### `claude-pilot login`
+
+Authenticate with GitHub Copilot using the device flow.
+
+```bash
+claude-pilot login
+```
+
+This will:
+
+1. Display a code and URL
+2. Open GitHub in your browser
+3. Enter the code to authorize
+4. Save credentials to `~/.config/claude-pilot/auth.json`
+
+### `claude-pilot logout`
+
+Clear credentials and stop the proxy.
+
+```bash
+claude-pilot logout
+```
+
+### `claude-pilot start`
+
+Start the proxy server in the background.
+
+```bash
+claude-pilot start
+claude-pilot start -p 8080  # Custom port
+```
+
+### `claude-pilot stop`
+
+Stop the running proxy server.
+
+```bash
+claude-pilot stop
+```
+
+### `claude-pilot status`
+
+Show proxy status and authentication state.
+
+```bash
+claude-pilot status
+```
+
+### `claude-pilot dashboard`
+
+Open the log viewer dashboard in your browser.
+
+```bash
+claude-pilot dashboard
+```
+
+## Configuration
+
+All configuration is stored in `~/.config/claude-pilot/`:
+
+| File             | Description                     |
+| ---------------- | ------------------------------- |
+| `auth.json`      | GitHub and Copilot tokens       |
+| `daemon.json`    | Running proxy state (PID, port) |
+| `server.log`     | Proxy server logs               |
+| `requests.jsonl` | Request/response logs           |
+
+## How It Works
+
+Claude Pilot runs a local proxy that:
+
+1. Receives requests from Claude Code in Anthropic's Messages API format
+2. Transforms them to OpenAI's Chat Completions format
+3. Forwards to GitHub Copilot's API
+4. Transforms responses back to Anthropic format
+
+This allows Claude Code to work with your existing GitHub Copilot subscription.
+
+## Troubleshooting
+
+### "Copilot CLI not found"
+
+Make sure the Copilot CLI is installed and in your PATH:
+
+```bash
+copilot --version
+```
+
+If not installed, see [Prerequisites](#2-copilot-cli).
+
+### "Claude CLI not found"
+
+Make sure Claude Code is installed:
+
+```bash
+claude --version
+```
+
+If not installed, see [Prerequisites](#3-claude-code).
+
+### "Token expired"
+
+Re-authenticate:
+
+```bash
+claude-pilot login
+```
+
+### Check logs
+
+```bash
+# Server logs
+cat ~/.config/claude-pilot/server.log
+
+# Request logs
+cat ~/.config/claude-pilot/requests.jsonl | jq .
+```
+
+## License
+
+MIT