opencode-with-claude 1.1.6 → 1.1.7

package/README.md

@@ -4,6 +4,16 @@
 
 Use [OpenCode](https://opencode.ai) with your [Claude Max](https://claude.ai) subscription.
 
+## What this is
+
+An [OpenCode](https://opencode.ai) plugin that runs [opencode-claude-max-proxy](https://github.com/rynfar/opencode-claude-max-proxy) for you: **start OpenCode once** and the proxy comes up with it; **quit OpenCode** and the proxy stops. No separate proxy CLI or Docker container to manage.
+
+**Compared to running the proxy yourself:**
+
+- **One process to think about** — OpenCode owns the proxy lifecycle (start/stop) instead of you juggling two things.
+- **Several OpenCode windows at once** — each instance gets its own proxy on an OS-assigned port, so ports do not collide and you avoid session issues from sharing one proxy across instances.
+- **Explicit session headers** — the plugin adds session tracking on outgoing API calls, so the proxy does not have to infer sessions from fingerprints alone.
+
 ## How It Works
 
 ```
@@ -14,15 +24,9 @@ Use [OpenCode](https://opencode.ai) with your [Claude Max](https://claude.ai) su
 └─────────────┘              └────────────────────┘       └─────────────────┘
 ```
 
-[OpenCode](https://opencode.ai) speaks the Anthropic REST API. Claude Max provides access via the [Claude Agent SDK](https://www.npmjs.com/package/@anthropic-ai/claude-agent-sdk) (not the REST API). The [opencode-claude-max-proxy](https://github.com/rynfar/opencode-claude-max-proxy) bridges the gap — it accepts API requests from OpenCode and translates them into Agent SDK calls using your Claude Max session.
-
 ## Quick Start
 
-There are three ways to get started: the **plugin** (recommended), the **standalone installer**, or **Docker**.
-
-### Option A: OpenCode Plugin (recommended)
-
-The plugin manages the proxy lifecycle automatically — it starts the proxy when OpenCode launches, configures the Anthropic provider, and cleans up on exit. Each OpenCode instance gets its own proxy on an OS-assigned port, so multiple instances can run simultaneously without conflicts.
+The plugin hooks into OpenCode's plugin system. When OpenCode launches, it starts the proxy, configures the Anthropic provider, and cleans everything up on exit.
 
 **1. Authenticate with Claude (one-time)**
 
@@ -50,7 +54,7 @@ Global (`~/.config/opencode/opencode.json`) or project-level:
 }
 ```
 
-The `apiKey` is a dummy value — authentication goes through your Claude Max session, not an API key. The `baseURL` points to the default proxy port (3456). If that port is already in use (e.g. another opencode instance), the plugin automatically starts the proxy on a different port and overrides the `baseURL` at runtime.
+> **Note:** The `apiKey` is a placeholder — authentication goes through your Claude Max session via `claude login`, not an API key. The `baseURL` is the default proxy port. If port 3456 is already in use (e.g., another OpenCode instance), the plugin automatically starts the proxy on a different port and overrides the `baseURL` at runtime.
 
 **3. Run OpenCode**
 
@@ -58,106 +62,6 @@ The `apiKey` is a dummy value — authentication goes through your Claude Max se
 opencode
 ```
 
-### Option B: Standalone Installer (`oc` launcher)
-
-A one-liner that installs all dependencies and gives you the `oc` command — no config files to edit.
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/ianjwhite99/opencode-with-claude/main/install.sh | bash
-```
-
-This installs:
-- [Claude Code CLI](https://www.npmjs.com/package/@anthropic-ai/claude-code) — authentication with Claude
-- [OpenCode](https://www.npmjs.com/package/opencode-ai) — the coding assistant
-- [opencode-claude-max-proxy](https://www.npmjs.com/package/opencode-claude-max-proxy) — bridges OpenCode to Claude Max
-- **`oc`** — launcher that ties it all together
-
-Then run:
-
-```bash
-cd your-project
-oc
-```
-
-The `oc` command starts the proxy in the background, waits for it to be ready, and launches OpenCode.
-
-### Option C: Docker
-
-Run everything in a container with the OpenCode web UI exposed on port 4096.
-
-```bash
-git clone https://github.com/ianjwhite99/opencode-with-claude.git
-cd opencode-with-claude
-
-# Build and start
-docker compose -f docker/docker-compose.yml up -d
-
-# Authenticate (first time only)
-docker exec -it -u opencode opencode-with-claude claude login
-
-# Open the web UI
-open http://localhost:4096
-```
-
-The container runs the proxy and OpenCode web UI together. Your `~/workspace` directory is mounted into the container, and Claude auth, OpenCode data, and config are persisted across restarts via Docker volumes.
-
-## Prerequisites
-
-- **Node.js >= 18** — [nodejs.org](https://nodejs.org) (or Bun/Deno) — not needed for Docker
-- **Claude Max subscription** — the $100/mo plan on [claude.ai](https://claude.ai)
-
-## `oc` Launcher Reference
-
-The `oc` launcher handles everything — starts the proxy, waits for health, launches OpenCode, and cleans up on exit:
-
-```bash
-oc              # Start OpenCode TUI in current directory
-oc web          # Start OpenCode web UI on port 4096
-oc update       # Update all components to latest versions
-oc --help       # Show help
-oc --version    # Show component versions
-```
-
-All arguments are passed through to `opencode`, so anything that works with `opencode` works with `oc`.
-
-### Installer Options
-
-```bash
-# Skip the Claude login prompt
-curl -fsSL ... | bash -s -- --no-auth
-
-# Don't modify shell PATH
-curl -fsSL ... | bash -s -- --no-modify-path
-
-# Show help
-curl -fsSL ... | bash -s -- --help
-```
-
-### Uninstalling
-
-Remove the `oc` launcher and clean up PATH entries:
-
-```bash
-curl -fsSL https://raw.githubusercontent.com/ianjwhite99/opencode-with-claude/main/install.sh | bash -s -- --uninstall
-```
-
-This removes the `oc` launcher from `~/.opencode/bin` and cleans up any PATH entries added to your shell config. To also remove the underlying tools:
-
-```bash
-npm uninstall -g @anthropic-ai/claude-code opencode-ai opencode-claude-max-proxy
-```
-
-## Configuration
-
-### Environment Variables
-
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `CLAUDE_PROXY_PORT` | `3456` | Preferred port for the proxy (falls back to a random port if in use) |
-| `CLAUDE_PROXY_WORKDIR` | `$PWD` | Working directory for the proxy |
-| `OC_SKIP_AUTH_CHECK` | unset | Set to `1` to skip Claude auth check on `oc` launch |
-| `OC_AUTO_UPDATE` | unset | Set to `true` or `1` to auto-update components on Docker container start |
-
 ## Troubleshooting
 
 ### "Claude Code CLI not found"
@@ -180,19 +84,6 @@ This opens a browser for OAuth. Your Claude Max subscription credentials are nee
 2. Ensure your internet connection is working
 3. If using a manual port override, check if it's in use: `lsof -i :$CLAUDE_PROXY_PORT`
 
-### Updating components
-
-```bash
-# oc launcher
-oc update
-
-# Plugin / manual
-npm install -g @anthropic-ai/claude-code opencode-ai opencode-claude-max-proxy
-
-# Docker
-docker compose -f docker/docker-compose.yml build --no-cache && docker compose -f docker/docker-compose.yml up -d
-```
-
 ## Development
 
 ### Project Structure
@@ -203,13 +94,6 @@ opencode-with-claude/
 │   ├── index.ts           # Plugin entry point
 │   ├── proxy.ts           # Proxy lifecycle management
 │   └── logger.ts          # Plugin logger
-├── bin/
-│   └── oc                 # Standalone launcher
-├── docker/
-│   ├── Dockerfile         # All-in-one Docker image
-│   ├── docker-compose.yml # Docker Compose config
-│   └── entrypoint.sh      # Docker entrypoint
-├── install.sh             # curl | bash installer
 ├── test/
 │   ├── run.sh             # Test runner
 │   └── opencode.json      # Test config
@@ -235,27 +119,19 @@ npm run build
 
 **Do I need an Anthropic API key?**
 
-No. The proxy authenticates through your Claude Max subscription via `claude login`. The plugin automatically sets a dummy API key — it's never actually used for authentication.
-
-**What happens if my Claude Max subscription expires?**
-
-The proxy will fail to authenticate. Run `claude auth status` to check. You'll need an active Claude Max ($100/mo) or Claude Max with Team ($200/mo) subscription.
-
-**Plugin, `oc`, or Docker — which should I use?**
-
-The **plugin** is recommended if you already use OpenCode — it integrates with OpenCode's plugin system and requires no extra commands. Use the **`oc` launcher** if you want a one-command install from scratch or prefer not to edit config files. Use **Docker** if you want an isolated environment or want to run the web UI as a service.
+No. Claude Max is not authenticated with API keys here. Run `claude login` once; the proxy uses that session (Agent SDK via OAuth). OpenCode still expects an `apiKey` field, so the plugin supplies a placeholder — it is not used for real auth.
 
-**Can I use this with multiple projects at the same time?**
+**What if my Claude Max subscription lapses?**
 
-Yes. The first instance uses port 3456 by default. Additional instances automatically fall back to a random OS-assigned port, so they all work simultaneously without any extra configuration.
+The proxy will fail to authenticate. Run `claude auth status`. You need an active Claude Max plan; see [claude.ai](https://claude.ai) for current options and pricing.
 
-**Is this the same as using the Anthropic API?**
+**Can I run several OpenCode instances at once?**
 
-Not exactly. The proxy translates between the Anthropic REST API format and the Claude Agent SDK. From OpenCode's perspective it looks like the API, but under the hood it uses your Claude Max session. Rate limits are determined by your Claude Max subscription, not API tier limits.
+Yes. The first instance uses port **3456** by default; others get a free OS-assigned port, so nothing extra to configure.
 
-**Why `claude login` instead of an API key?**
+**Is this the same as using the Anthropic API directly?**
 
-Claude Max doesn't provide API access. Authentication goes through the Claude Code CLI's OAuth flow, which grants an Agent SDK session token tied to your subscription.
+Not exactly. OpenCode speaks Anthropic-style HTTP to the local proxy; the proxy maps requests to the Claude Agent SDK and your Claude Max session. Usage limits follow your Max subscription, not Anthropic API billing tiers.
 
 ## Disclaimer
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opencode-with-claude",
   "description": "OpenCode plugin to use your Claude Max subscription via local proxy",
-  "version": "1.1.6",
+  "version": "1.1.7",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",