pennyrouter 0.1.0 → 0.1.2

package/README.md

@@ -1,15 +1,45 @@
 # PennyRouter CLI
 
-Local installer for PennyRouter coding-agent integrations.
+Official local installer for [PennyRouter](https://pennyrouter.com) coding-agent integrations.
+
+PennyRouter is a model gateway for coding tools. This CLI handles the local setup work that
+agents should not do by hand: browser authorization, API-key handoff, config edits, backups,
+status checks, and uninstall metadata.
+
+## Usage
 
 ```bash
 npx pennyrouter install
-npx pennyrouter install --harness opencode,codex
+npx pennyrouter install --harness claude-code,cline,opencode,codex
 npx pennyrouter uninstall
 npx pennyrouter status
 ```
 
-The CLI owns local config changes, backups, browser authorization, and uninstall metadata.
-The machine-readable pages at `https://pennyrouter.com/install` and
-`https://pennyrouter.com/uninstall` should tell coding agents to invoke this CLI instead of
-editing config files directly.
+## Supported Tools
+
+- Claude Code
+- Cline (manual setup instructions; no VS Code settings mutation)
+- Codex
+- opencode
+
+## Agent Flow
+
+Users can ask a coding agent to follow:
+
+```text
+https://pennyrouter.com/install
+```
+
+That machine-readable page tells the agent to invoke this CLI instead of editing config files
+directly.
+
+## What It Changes
+
+The CLI writes only selected local tool configuration files, saves backups under the local
+PennyRouter state directory, and records an uninstall manifest.
+
+It does not delete PennyRouter accounts, credits, or remote API keys.
+
+## License
+
+MIT

package/package.json

@@ -1,7 +1,15 @@
 {
   "name": "pennyrouter",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Install and manage PennyRouter local coding-agent integrations.",
+  "homepage": "https://pennyrouter.com",
+  "bugs": {
+    "url": "https://github.com/jduke99/pennyrouter-cli/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jduke99/pennyrouter-cli.git"
+  },
   "type": "module",
   "bin": {
     "pennyrouter": "bin/pennyrouter.js"

package/src/cli.js

@@ -1,6 +1,8 @@
 import { spawnSync } from "node:child_process";
 import { createInterface } from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
+import { claudeCodeHarness } from "./harnesses/claude-code.js";
+import { clineHarness } from "./harnesses/cline.js";
 import { codexHarness } from "./harnesses/codex.js";
 import { opencodeHarness } from "./harnesses/opencode.js";
 import {
@@ -19,23 +21,12 @@ import {
 } from "./state.js";
 
 const HARNESS_BY_ID = {
+  "claude-code": claudeCodeHarness,
+  cline: clineHarness,
   opencode: opencodeHarness,
   codex: codexHarness,
 };
 
-const PLANNED_HARNESSES = [
-  {
-    id: "claude-code",
-    name: "Claude Code",
-    reason: "Claude Code support is planned; this preview CLI does not mutate Claude settings yet.",
-  },
-  {
-    id: "cline",
-    name: "Cline",
-    reason: "Cline support is planned; this preview CLI does not mutate VS Code settings yet.",
-  },
-];
-
 export async function main(argv = process.argv.slice(2)) {
   const { command, flags } = parseArgs(argv);
 
@@ -201,10 +192,11 @@ async function status() {
   }
 
   for (const record of records) {
-    console.log(`${record.harness}: installed`);
-    console.log(`  config: ${record.config_path}`);
+    console.log(`${record.harness}: ${record.manual_required ? "manual setup shown" : "installed"}`);
+    if (record.config_path) console.log(`  config: ${record.config_path}`);
     if (record.backup_path) console.log(`  backup: ${record.backup_path}`);
     if (record.installed_at) console.log(`  installed: ${record.installed_at}`);
+    if (record.manual_required) console.log("  note: finish or remove this integration in the tool UI");
   }
 }
 
@@ -215,17 +207,13 @@ async function selectHarnesses(flags) {
     if (await harness.detect()) detected.push(harness);
   }
 
-  for (const planned of PLANNED_HARNESSES) {
-    if (requested.includes(planned.id)) console.log(`${planned.name}: ${planned.reason}`);
-  }
-
   if (requested.length > 0) {
     return requested.map((id) => HARNESS_BY_ID[id]).filter(Boolean);
   }
 
   if (detected.length === 0) {
     console.log("No supported harness configs were detected.");
-    console.log("Use --harness opencode,codex to create config for specific tools.");
+    console.log("Use --harness claude-code,cline,opencode,codex to create config for specific tools.");
     return [];
   }
 
@@ -291,14 +279,14 @@ function printHelp() {
   console.log(`PennyRouter CLI
 
 Usage:
-  pennyrouter install [--harness opencode,codex] [--all] [--yes] [--dry-run]
-  pennyrouter uninstall [--harness opencode,codex] [--all] [--yes]
+  pennyrouter install [--harness claude-code,cline,opencode,codex] [--all] [--yes] [--dry-run]
+  pennyrouter uninstall [--harness claude-code,cline,opencode,codex] [--all] [--yes]
   pennyrouter status
 
 Examples:
   npx pennyrouter install
   npx pennyrouter install --all
-  npx pennyrouter install --harness opencode,codex --yes
+  npx pennyrouter install --harness claude-code,cline,opencode,codex --yes
   npx pennyrouter uninstall
 `);
 }

package/src/harnesses/claude-code.js

@@ -0,0 +1,56 @@
+import { atomicWrite, backupFile, compactHome, exists, expandHome, readJsonFile } from "../state.js";
+
+const CONFIG_PATH = "~/.claude/settings.json";
+
+export const claudeCodeHarness = {
+  id: "claude-code",
+  name: "Claude Code",
+
+  async detect() {
+    return exists(CONFIG_PATH);
+  },
+
+  async planInstall() {
+    return {
+      configPath: expandHome(CONFIG_PATH),
+      summary: [
+        `write ${CONFIG_PATH}`,
+        "set Anthropic-compatible base URL to PennyRouter",
+        "store the PennyRouter API key without printing it",
+      ],
+    };
+  },
+
+  async install({ apiKey, gatewayBaseUrl, plan }) {
+    const backupPath = await backupFile(CONFIG_PATH, "claude-code");
+    const current = (await readJsonFile(CONFIG_PATH, null)) || {};
+    current.env ||= {};
+    current.env.ANTHROPIC_BASE_URL = gatewayBaseUrl;
+    current.env.ANTHROPIC_API_KEY = apiKey;
+
+    await atomicWrite(CONFIG_PATH, `${JSON.stringify(current, null, 2)}\n`);
+
+    return {
+      harness: "claude-code",
+      config_path: compactHome(plan.configPath),
+      backup_path: backupPath ? compactHome(backupPath) : null,
+      installed_at: new Date().toISOString(),
+      restart: "restart Claude Code",
+      changes: {
+        env_keys: ["ANTHROPIC_BASE_URL", "ANTHROPIC_API_KEY"],
+      },
+    };
+  },
+
+  async uninstall(record) {
+    const current = (await readJsonFile(record.config_path, null)) || {};
+    if (current.env?.ANTHROPIC_BASE_URL?.includes("pennyrouter.com")) {
+      delete current.env.ANTHROPIC_BASE_URL;
+      if (typeof current.env.ANTHROPIC_API_KEY === "string" && current.env.ANTHROPIC_API_KEY.startsWith("pr-")) {
+        delete current.env.ANTHROPIC_API_KEY;
+      }
+    }
+    if (current.env && Object.keys(current.env).length === 0) delete current.env;
+    await atomicWrite(record.config_path, `${JSON.stringify(current, null, 2)}\n`);
+  },
+};

package/src/harnesses/cline.js

@@ -0,0 +1,76 @@
+import { spawnSync } from "node:child_process";
+
+export const clineHarness = {
+  id: "cline",
+  name: "Cline",
+
+  async detect() {
+    return false;
+  },
+
+  async planInstall() {
+    return {
+      configPath: null,
+      summary: [
+        "show manual OpenAI Compatible setup instructions",
+        "do not write VS Code settings or extension storage",
+        "record that manual Cline setup instructions were shown",
+      ],
+    };
+  },
+
+  async install({ apiKey, gatewayBaseUrl }) {
+    const copied = copyToClipboard(apiKey);
+
+    console.log("");
+    console.log("Cline manual setup");
+    console.log("  Open Cline settings in VS Code and set:");
+    console.log("  - API Provider: OpenAI Compatible");
+    console.log(`  - Base URL: ${gatewayBaseUrl}/v1`);
+    console.log(`  - API Key: ${copied ? "copied to clipboard" : "copy from your PennyRouter dashboard"}`);
+    console.log("  - Model ID: pennyrouter/auto");
+    console.log("");
+    console.log("The CLI did not write VS Code settings because Cline stores provider config differently across versions.");
+    if (!copied) {
+      console.log("Clipboard copy failed, so the key was not printed. Open PennyRouter and create or reveal a key manually for Cline.");
+    }
+
+    return {
+      harness: "cline",
+      config_path: null,
+      backup_path: null,
+      installed_at: new Date().toISOString(),
+      manual_required: true,
+      restart: "save Cline settings, then restart VS Code or reload the Cline window if it does not pick up the provider",
+      changes: {
+        provider: "OpenAI Compatible",
+        base_url: `${gatewayBaseUrl}/v1`,
+        model: "pennyrouter/auto",
+      },
+    };
+  },
+
+  async uninstall() {
+    console.log("");
+    console.log("Cline manual uninstall");
+    console.log("  Open Cline settings in VS Code and remove or replace the PennyRouter OpenAI Compatible provider:");
+    console.log("  - Base URL: https://api.pennyrouter.com/v1");
+    console.log("  - API Key: pr-...");
+    console.log("  - Model ID: pennyrouter/auto");
+  },
+};
+
+function copyToClipboard(text) {
+  const commands =
+    process.platform === "darwin"
+      ? [["pbcopy"]]
+      : process.platform === "win32"
+        ? [["clip"]]
+        : [["xclip", "-selection", "clipboard"], ["xsel", "--clipboard", "--input"]];
+
+  for (const [command, ...args] of commands) {
+    const result = spawnSync(command, args, { input: text, stdio: ["pipe", "ignore", "ignore"] });
+    if (result.status === 0) return true;
+  }
+  return false;
+}