diff --git a/README.md b/README.md index 0a8e0d2a..93279c49 100644 --- a/README.md +++ b/README.md @@ -104,6 +104,11 @@ Best if you want local inference on Apple Silicon with Atomic Chat. See [Advance --- + +## VS Code Extension + +Want a native VS Code experience? Use the in-repo extension at `vscode-extension/openclaude-vscode` for one-command terminal launch and the `OpenClaude Terminal Black` theme. + ## What Works - **All tools**: Bash, FileRead, FileWrite, FileEdit, Glob, Grep, WebFetch, WebSearch, Agent, MCP, LSP, NotebookEdit, Tasks diff --git a/vscode-extension/openclaude-vscode/README.md b/vscode-extension/openclaude-vscode/README.md new file mode 100644 index 00000000..9d67cad1 --- /dev/null +++ b/vscode-extension/openclaude-vscode/README.md @@ -0,0 +1,44 @@ +# OpenClaude VS Code Extension + +A sleek VS Code companion for OpenClaude with a visual **Control Center** plus terminal-first workflows. + +## Features + +- **Control Center sidebar UI** in the Activity Bar: + - Launch OpenClaude + - Open repository/docs + - Open VS Code theme picker +- **Terminal launch command**: `OpenClaude: Launch in Terminal` +- **Built-in dark theme**: `OpenClaude Terminal Black` (terminal-inspired, low-glare, neon accents) + +## Requirements + +- VS Code `1.95+` +- `openclaude` available in your terminal PATH (`npm install -g @gitlawb/openclaude`) + +## Commands + +- `OpenClaude: Open Control Center` +- `OpenClaude: Launch in Terminal` +- `OpenClaude: Open Repository` + +## Settings + +- `openclaude.launchCommand` (default: `openclaude`) +- `openclaude.terminalName` (default: `OpenClaude`) +- `openclaude.useOpenAIShim` (default: `true`) + +## Development + +From this folder: + +```bash +npm run lint +``` + +To package (optional): + +```bash +npm run package +``` + diff --git a/vscode-extension/openclaude-vscode/media/openclaude.svg b/vscode-extension/openclaude-vscode/media/openclaude.svg new file mode 100644 index 00000000..b492c423 --- /dev/null +++ b/vscode-extension/openclaude-vscode/media/openclaude.svg @@ -0,0 +1,6 @@ + diff --git a/vscode-extension/openclaude-vscode/package.json b/vscode-extension/openclaude-vscode/package.json new file mode 100644 index 00000000..4cd42b1d --- /dev/null +++ b/vscode-extension/openclaude-vscode/package.json @@ -0,0 +1,101 @@ +{ + "name": "openclaude-vscode", + "displayName": "OpenClaude", + "description": "Sleek VS Code extension for OpenClaude with a visual Control Center and terminal-aligned theme.", + "version": "0.1.1", + "publisher": "devnull-bootloader", + "engines": { + "vscode": "^1.95.0" + }, + "categories": [ + "Themes", + "Other" + ], + "activationEvents": [ + "onCommand:openclaude.start", + "onCommand:openclaude.openDocs", + "onCommand:openclaude.openControlCenter", + "onView:openclaude.controlCenter" + ], + "main": "./src/extension.js", + "contributes": { + "commands": [ + { + "command": "openclaude.start", + "title": "OpenClaude: Launch in Terminal", + "category": "OpenClaude" + }, + { + "command": "openclaude.openDocs", + "title": "OpenClaude: Open Repository", + "category": "OpenClaude" + }, + { + "command": "openclaude.openControlCenter", + "title": "OpenClaude: Open Control Center", + "category": "OpenClaude" + } + ], + "viewsContainers": { + "activitybar": [ + { + "id": "openclaude", + "title": "OpenClaude", + "icon": "media/openclaude.svg" + } + ] + }, + "views": { + "openclaude": [ + { + "id": "openclaude.controlCenter", + "name": "Control Center", + "type": "webview" + } + ] + }, + "configuration": { + "title": "OpenClaude", + "properties": { + "openclaude.launchCommand": { + "type": "string", + "default": "openclaude", + "description": "Command run in the integrated terminal when launching OpenClaude." + }, + "openclaude.terminalName": { + "type": "string", + "default": "OpenClaude", + "description": "Integrated terminal tab name for OpenClaude sessions." + }, + "openclaude.useOpenAIShim": { + "type": "boolean", + "default": true, + "description": "Set CLAUDE_CODE_USE_OPENAI=1 in launched OpenClaude terminals." + } + } + }, + "themes": [ + { + "label": "OpenClaude Terminal Black", + "uiTheme": "vs-dark", + "path": "./themes/OpenClaude-Terminal-Black.json" + } + ] + }, + "scripts": { + "lint": "node --check ./src/extension.js", + "package": "npx @vscode/vsce package --no-dependencies" + }, + "keywords": [ + "openclaude", + "terminal", + "theme", + "cli", + "llm" + ], + "repository": { + "type": "git", + "url": "https://github.com/devNull-bootloader/openclaude" + }, + "license": "MIT" +} diff --git a/vscode-extension/openclaude-vscode/src/extension.js b/vscode-extension/openclaude-vscode/src/extension.js new file mode 100644 index 00000000..daf48133 --- /dev/null +++ b/vscode-extension/openclaude-vscode/src/extension.js @@ -0,0 +1,140 @@ +const vscode = require('vscode'); +const crypto = require('crypto'); + +function launchOpenClaude() { + const configured = vscode.workspace.getConfiguration('openclaude'); + const launchCommand = configured.get('launchCommand', 'openclaude'); + const terminalName = configured.get('terminalName', 'OpenClaude'); + + const terminal = vscode.window.createTerminal({ + name: terminalName, + env: { + CLAUDE_CODE_USE_OPENAI: configured.get('useOpenAIShim', true) ? '1' : undefined, + }, + }); + + terminal.show(true); + terminal.sendText(launchCommand, true); +} + +class OpenClaudeControlCenterProvider { + resolveWebviewView(webviewView) { + webviewView.webview.options = { enableScripts: true }; + webviewView.webview.html = this.getHtml(webviewView.webview); + + webviewView.webview.onDidReceiveMessage(async (message) => { + if (message?.type === 'launch') { + launchOpenClaude(); + return; + } + + if (message?.type === 'docs') { + await vscode.env.openExternal(vscode.Uri.parse('https://github.com/devNull-bootloader/openclaude')); + return; + } + + if (message?.type === 'theme') { + await vscode.commands.executeCommand('workbench.action.selectTheme'); + } + }); + } + + getHtml(webview) { + const nonce = crypto.randomBytes(16).toString('base64'); + return ` + +
+ + + + + + +