opencode-kilocode-auth 1.0.0

package/README.md

@@ -0,0 +1,229 @@
+# OpenCode Kilo Code Auth Plugin
+
+An OpenCode plugin for authenticating with Kilo Code and accessing various AI models, including the **Giga Potato** model - a stealth model optimized for agentic programming.
+
+## Features
+
+- **Kilo Code Authentication**: Login via browser-based device auth or manual token entry
+- **300+ AI Models**: Access to Claude, GPT, Gemini, DeepSeek, Llama, and more
+- **Giga Potato Model**: Free stealth model optimized for agentic programming with vision support
+- **Model Selection**: Browse and select from available models
+- **Zero Configuration**: Automatic request routing through Kilo Code API
+
+## Installation
+
+### Method 1: Add to opencode.json (Recommended)
+
+Add the plugin to your OpenCode configuration file (`~/.config/opencode/opencode.json`):
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    "opencode-kilocode-auth"
+  ],
+  "provider": {
+    "kilocode": {
+      "models": {
+        "giga-potato": {}
+      }
+    }
+  },
+  "model": "kilocode/giga-potato"
+}
+```
+
+### Method 2: Local Plugin Directory
+
+1. Copy the plugin to your OpenCode plugins directory:
+
+```bash
+# Create plugins directory
+mkdir -p ~/.config/opencode/plugins
+
+# Copy plugin file
+cp path/to/opencode-kilocode-auth/src/plugin.ts ~/.config/opencode/plugins/kilocode.ts
+```
+
+2. OpenCode will automatically load plugins from the `~/.config/opencode/plugins/` directory.
+
+### Method 3: Install via npm/bun
+
+```bash
+# Navigate to your opencode config directory
+cd ~/.config/opencode
+
+# Install the plugin
+bun add opencode-kilocode-auth
+
+# Or using npm
+npm install opencode-kilocode-auth
+```
+
+Then add to your `opencode.json`:
+
+```json
+{
+  "plugin": ["opencode-kilocode-auth"]
+}
+```
+
+## Authentication
+
+When you run OpenCode, you'll see "kilocode" as an available provider. Select it and choose an auth method:
+
+1. **Login with Kilo Code** (OAuth): Opens browser for secure device auth
+2. **Enter Kilo Code API Token**: Enter your API token directly
+
+### Getting a Kilo Code Token
+
+1. Go to [https://kilo.ai](https://kilo.ai)
+2. Sign up or log in
+3. Navigate to Settings → API Keys
+4. Generate a new API key
+
+## Giga Potato Model
+
+The **Giga Potato** model is a stealth model deeply optimized for agentic programming:
+
+| Feature | Value |
+|---------|-------|
+| **Model ID** | `giga-potato` |
+| **Context Window** | 256K tokens |
+| **Max Output** | 32K tokens |
+| **Vision Support** | Yes (can analyze images) |
+| **Tool Support** | Yes (write_file, edit_file) |
+| **Reasoning** | Yes |
+| **Price** | **FREE** |
+
+### Using Giga Potato
+
+Set it as your default model in `opencode.json`:
+
+```json
+{
+  "model": "kilocode/giga-potato"
+}
+```
+
+Or select it interactively when prompted for a model.
+
+## Available Models
+
+### Free Models
+
+| Model | Description |
+|-------|-------------|
+| `giga-potato` | Stealth model for agentic programming (256K context, vision) |
+| `x-ai/grok-code-fast-1` | xAI Grok optimized for fast code generation |
+| `mistralai/devstral-2512:free` | Mistral's development model |
+| `corethink:free` | CoreThink reasoning model |
+
+### Premium Models (via Kilo Code subscription)
+
+| Model | Description |
+|-------|-------------|
+| `anthropic/claude-opus-4.5` | Latest Claude Opus |
+| `anthropic/claude-sonnet-4.5` | Latest Claude Sonnet |
+| `openai/gpt-5.2` | Latest GPT model |
+| `google/gemini-3-pro-preview` | Gemini 3 Pro |
+| `deepseek/deepseek-r1` | DeepSeek reasoning model |
+
+## Configuration Example
+
+Full `opencode.json` example:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [
+    "opencode-kilocode-auth"
+  ],
+  "provider": {
+    "kilocode": {
+      "models": {
+        "giga-potato": {
+          "name": "Giga Potato",
+          "contextLength": 256000,
+          "maxTokens": 32000
+        },
+        "anthropic/claude-sonnet-4": {},
+        "openai/gpt-4o": {}
+      }
+    }
+  },
+  "model": "kilocode/giga-potato",
+  "agent": {
+    "build": {
+      "model": "kilocode/giga-potato"
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `KILOCODE_TOKEN` | Pre-set your Kilo Code API token |
+| `KILOCODE_BACKEND_BASE_URL` | Custom backend URL (for development) |
+
+## How It Works
+
+1. **Authentication**: Uses device auth flow (like GitHub CLI) or direct token entry
+2. **Request Routing**: Intercepts AI requests and routes them through Kilo Code's OpenRouter-compatible API
+3. **Model Access**: Provides access to 300+ models through a single authentication
+4. **Cost Tracking**: Billing is handled by Kilo Code, costs show as $0 in OpenCode
+
+## Troubleshooting
+
+### Plugin not loading
+
+Make sure the plugin is properly installed:
+
+```bash
+# Check if plugin is in node_modules
+ls ~/.config/opencode/node_modules/opencode-kilocode-auth
+
+# Or check plugins directory
+ls ~/.config/opencode/plugins/
+```
+
+### Authentication failing
+
+1. Check your internet connection
+2. Try logging in at [https://kilo.ai](https://kilo.ai) first
+3. Generate a new API token if the old one expired
+
+### Model not found
+
+Make sure you're using the correct model ID format: `kilocode/model-name`
+
+For example:
+- `kilocode/giga-potato`
+- `kilocode/anthropic/claude-sonnet-4`
+
+## Development
+
+```bash
+# Clone the repo
+git clone <repo-url>
+cd opencode-kilocode-auth
+
+# Install dependencies
+bun install
+
+# Test the API
+bun run test/api-test.ts
+
+# Build
+bun run build
+```
+
+## License
+
+MIT
+
+## Credits
+
+Ported from [Kilo Code](https://kilo.ai) for OpenCode integration.

package/index.ts

@@ -0,0 +1,11 @@
+// Plugin export - matches opencode-gemini-auth pattern
+export { KilocodeAuthPlugin } from "./src/plugin"
+
+// Types only
+export type { KilocodeAuth } from "./src/plugin"
+
+export type {
+  ModelInfo,
+  KilocodeOrganization,
+  KilocodeProfileData,
+} from "./src/plugin/types"

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "opencode-kilocode-auth",
+  "module": "index.ts",
+  "version": "1.0.0",
+  "author": "ported from Kilo Code",
+  "description": "OpenCode plugin for Kilo Code authentication with support for various models including Giga Potato",
+  "files": [
+    "index.ts",
+    "src"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.1.25",
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {}
+}

package/src/cli/select-model.ts

@@ -0,0 +1,111 @@
+#!/usr/bin/env bun
+/**
+ * CLI tool for selecting Kilo Code models interactively
+ *
+ * Usage:
+ *   bun run src/cli/select-model.ts [token]
+ *
+ * If token is not provided, it will use KILOCODE_TOKEN environment variable
+ */
+
+import { fetchAllModels, getFeaturedModels, formatModelDisplay, GIGA_POTATO_MODEL } from "../kilocode/models";
+import { getKilocodeDefaultModel } from "../kilocode/auth";
+import type { ModelInfo } from "../plugin/types";
+
+async function selectModel(token?: string): Promise<void> {
+  const authToken = token || process.env.KILOCODE_TOKEN;
+
+  if (!authToken) {
+    console.log("Kilo Code Model Selector");
+    console.log("========================\n");
+    console.log("No token provided. Showing featured models:\n");
+
+    // Show featured models without auth
+    console.log("=== FREE Models (Recommended) ===");
+    console.log(`1. ${GIGA_POTATO_MODEL.name}`);
+    console.log(`   ID: ${GIGA_POTATO_MODEL.id}`);
+    console.log(`   Context: ${GIGA_POTATO_MODEL.contextWindow / 1000}K tokens`);
+    console.log(`   Max Output: ${GIGA_POTATO_MODEL.maxTokens} tokens`);
+    console.log(`   Vision: ${GIGA_POTATO_MODEL.supportsImages ? "Yes" : "No"}`);
+    console.log(`   Reasoning: ${GIGA_POTATO_MODEL.supportsReasoning ? "Yes" : "No"}`);
+    console.log(`   Price: FREE`);
+    console.log(`   ${GIGA_POTATO_MODEL.description}\n`);
+
+    console.log("To see all available models, provide your Kilo Code token:");
+    console.log("  KILOCODE_TOKEN=your_token bun run src/cli/select-model.ts");
+    console.log("  OR");
+    console.log("  bun run src/cli/select-model.ts your_token");
+    return;
+  }
+
+  console.log("Kilo Code Model Selector");
+  console.log("========================\n");
+  console.log("Fetching available models...\n");
+
+  try {
+    const models = await fetchAllModels(authToken);
+    const defaultModel = await getKilocodeDefaultModel(authToken);
+
+    if (models.length === 0) {
+      console.log("No models available. Please check your token.");
+      return;
+    }
+
+    console.log(`Found ${models.length} models\n`);
+    console.log(`Current default: ${defaultModel}\n`);
+
+    // Group models by category
+    const freeModels = models.filter(
+      (m) => m.inputPrice === 0 && m.outputPrice === 0
+    );
+    const paidModels = models.filter(
+      (m) => (m.inputPrice ?? 0) > 0 || (m.outputPrice ?? 0) > 0
+    );
+
+    // Show free models first
+    console.log("=== FREE Models ===");
+    for (const model of freeModels.slice(0, 10)) {
+      const isDefault = model.id === defaultModel ? " [DEFAULT]" : "";
+      const vision = model.supportsImages ? " [Vision]" : "";
+      console.log(`  ${model.id}${isDefault}${vision}`);
+      console.log(`    ${model.name}`);
+      if (model.contextWindow) {
+        console.log(`    Context: ${Math.round(model.contextWindow / 1000)}K tokens`);
+      }
+      console.log();
+    }
+
+    // Show featured paid models
+    console.log("=== Featured Paid Models ===");
+    const featuredPaid = paidModels
+      .filter((m) => m.preferredIndex !== undefined)
+      .sort((a, b) => (a.preferredIndex ?? 999) - (b.preferredIndex ?? 999))
+      .slice(0, 10);
+
+    for (const model of featuredPaid) {
+      const isDefault = model.id === defaultModel ? " [DEFAULT]" : "";
+      const vision = model.supportsImages ? " [Vision]" : "";
+      const price = `$${((model.inputPrice ?? 0) * 1000000).toFixed(2)}/${((model.outputPrice ?? 0) * 1000000).toFixed(2)} per 1M`;
+      console.log(`  ${model.id}${isDefault}${vision}`);
+      console.log(`    ${model.name}`);
+      console.log(`    Price: ${price}`);
+      if (model.contextWindow) {
+        console.log(`    Context: ${Math.round(model.contextWindow / 1000)}K tokens`);
+      }
+      console.log();
+    }
+
+    console.log("---");
+    console.log("To use a model, set it in your OpenCode config:");
+    console.log('  provider.options.model = "giga-potato"');
+    console.log("\nOr use environment variable:");
+    console.log("  OPENCODE_KILOCODE_MODEL=giga-potato");
+
+  } catch (error) {
+    console.error("Error fetching models:", error);
+  }
+}
+
+// Run the CLI
+const token = process.argv[2];
+selectModel(token);

package/src/constants.ts

@@ -0,0 +1,62 @@
+/**
+ * Constants used for Kilo Code authentication and API integration.
+ */
+
+/**
+ * Default Kilo Code backend URL for production
+ */
+export const DEFAULT_KILOCODE_BACKEND_URL = "https://kilo.ai";
+
+/**
+ * Kilo Code API base URL for production
+ */
+export const KILOCODE_API_BASE_URL = "https://api.kilo.ai";
+
+/**
+ * Provider identifier shared between the plugin loader and credential store.
+ */
+export const KILOCODE_PROVIDER_ID = "kilocode";
+
+/**
+ * Default headers for Kilo Code API requests
+ */
+export const DEFAULT_HEADERS = {
+  "Content-Type": "application/json",
+  "User-Agent": "opencode-kilocode-auth/1.0.0",
+} as const;
+
+/**
+ * Kilo Code custom headers
+ */
+export const X_KILOCODE_ORGANIZATIONID = "X-KILOCODE-ORGANIZATIONID";
+export const X_KILOCODE_TASKID = "X-KILOCODE-TASKID";
+export const X_KILOCODE_PROJECTID = "X-KILOCODE-PROJECTID";
+export const X_KILOCODE_EDITORNAME = "X-KILOCODE-EDITORNAME";
+
+/**
+ * Default model ID if none is specified
+ * Using Giga Potato as default since it's free and optimized for agentic programming
+ */
+export const DEFAULT_MODEL_ID = "giga-potato";
+
+/**
+ * Giga Potato model ID - a stealth model optimized for agentic programming
+ * Features:
+ * - 256K context window
+ * - 32K max completion tokens
+ * - Supports images/vision
+ * - Supports tools (write_file, edit_file)
+ * - Supports reasoning
+ * - FREE
+ */
+export const GIGA_POTATO_MODEL_ID = "giga-potato";
+
+/**
+ * Polling interval for device auth (in ms)
+ */
+export const DEVICE_AUTH_POLL_INTERVAL_MS = 3000;
+
+/**
+ * OpenRouter-compatible endpoint path
+ */
+export const OPENROUTER_PATH = "/api/openrouter/";