@twigpine/openclaude 0.0.0 → 0.32.0

package/docs/windows-aliases-and-launchers.md

@@ -0,0 +1,176 @@
+# Windows aliases and launchers
+
+This page documents optional PowerShell helper functions for launching OpenClaude on Windows after a global npm install.
+
+These helpers are designed for the installed package workflow:
+
+~~~powershell
+npm install -g @twigpine/openclaude
+~~~
+
+The helpers use the installed `openclaude` CLI command. They do not require a source checkout and do not call source-only `bun run scripts/*.ts` entrypoints.
+
+## One-time setup
+
+Run this once in PowerShell:
+
+~~~powershell
+$packageRoot = Join-Path (npm root -g) "@twigpine/openclaude"
+$aliases = Join-Path $packageRoot "scripts\windows\openclaude-aliases.ps1"
+
+if (-not (Test-Path $aliases)) {
+  throw "Alias script not found at $aliases. Update or reinstall @twigpine/openclaude."
+}
+
+if (-not (Test-Path $PROFILE)) {
+  New-Item -ItemType File -Path $PROFILE -Force | Out-Null
+}
+
+$profileLine = ". `"$aliases`""
+
+if (-not (Select-String -Path $PROFILE -Pattern ([regex]::Escape($profileLine)) -Quiet)) {
+  Add-Content -Path $PROFILE -Value "`n$profileLine"
+}
+
+. $aliases
+oc-help
+~~~
+
+Open a new PowerShell window after setup, or dot-source the profile:
+
+~~~powershell
+. $PROFILE
+~~~
+
+### Upgrading from `@gitlawb/openclaude`
+
+The setup above adds a line to `$PROFILE` that loads the helpers from the
+installed package folder. If you ran it while the package was still named
+`@gitlawb/openclaude`, that line points at a folder that no longer exists once
+you switch packages, and every new PowerShell window reports an error.
+
+After installing `@twigpine/openclaude`, remove the old line and run the
+one-time setup again:
+
+~~~powershell
+(Get-Content $PROFILE) | Where-Object { $_ -notmatch '@gitlawb[\\/]openclaude' } | Set-Content $PROFILE
+~~~
+
+## Daily commands
+
+### Launch OpenClaude using the installed CLI
+
+~~~powershell
+oc
+~~~
+
+You can pass normal CLI arguments through `oc`:
+
+~~~powershell
+oc --version
+oc --help
+~~~
+
+### Launch with local Ollama/OpenAI-compatible environment hints
+
+~~~powershell
+oc-local
+~~~
+
+By default, this uses local Ollama through the OpenAI-compatible API:
+
+~~~text
+CLAUDE_CODE_USE_OPENAI=1
+OPENAI_BASE_URL=http://localhost:11434/v1
+OPENAI_MODEL=llama3.1:8b
+~~~
+
+To use a different local model for that invocation:
+
+~~~powershell
+oc-local -Model "qwen2.5-coder:7b"
+~~~
+
+The environment overrides are scoped to that single `openclaude` invocation. A later plain `oc` call returns to normal installed CLI behavior and saved-provider-profile behavior.
+
+### Launch with low-latency local defaults
+
+~~~powershell
+oc-fast
+~~~
+
+To use a different model:
+
+~~~powershell
+oc-fast -Model "qwen2.5-coder:7b"
+~~~
+
+Like `oc-local`, the environment overrides are scoped to that single invocation.
+
+### Open the provider manager
+
+~~~powershell
+oc-provider
+~~~
+
+This opens the provider manager through the installed OpenClaude CLI.
+
+### Check local Ollama state
+
+~~~powershell
+oc-check
+~~~
+
+To check a specific model:
+
+~~~powershell
+oc-check -Model "qwen2.5-coder:7b"
+~~~
+
+### Pull/check a local model, then launch local mode
+
+~~~powershell
+oc-init
+~~~
+
+To choose a model:
+
+~~~powershell
+oc-init -Model "qwen2.5-coder:7b"
+~~~
+
+To skip pulling the model and only check/launch:
+
+~~~powershell
+oc-init -Model "qwen2.5-coder:7b" -SkipModelPull
+~~~
+
+`oc-init` does not save a provider profile. It pulls/checks the local Ollama model and then launches `oc-local`.
+
+### Show quick help
+
+~~~powershell
+oc-help
+~~~
+
+## Command summary
+
+| Command | Purpose |
+| --- | --- |
+| `oc` | Launch OpenClaude using the installed CLI and saved/default behavior |
+| `oc-local` | Launch once with local Ollama/OpenAI-compatible environment hints |
+| `oc-fast` | Launch once with local Ollama/OpenAI-compatible low-latency hints |
+| `oc-provider` | Open the provider manager |
+| `oc-check` | Show local Ollama install/listening/model state |
+| `oc-init` | Pull/check a local Ollama model, then launch local mode |
+| `oc-help` | Show quick command help |
+
+## Notes
+
+These helpers are intentionally global-install oriented. They use the installed CLI instead of source-checkout development scripts.
+
+For advanced provider setup, use the built-in provider manager:
+
+~~~powershell
+oc-provider
+~~~

package/package.json

@@ -1,7 +1,221 @@
 {
   "name": "@twigpine/openclaude",
-  "version": "0.0.0",
-  "description": "Placeholder. OpenClaude is moving here from @gitlawb/openclaude; the first release is on its way.",
+  "version": "0.32.0",
+  "description": "OpenClaude opens coding-agent workflows to any LLM — OpenAI, Gemini, DeepSeek, Ollama, and 200+ models",
+  "type": "module",
+  "bin": {
+    "openclaude": "./bin/openclaude"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    "./dist/cli.mjs": "./dist/cli.mjs",
+    "./sdk": {
+      "types": "./src/entrypoints/sdk.d.ts",
+      "import": "./dist/sdk.mjs"
+    }
+  },
+  "files": [
+    "bin/",
+    "dist/cli.mjs",
+    "dist/sdk.mjs",
+    "src/entrypoints/sdk.d.ts",
+    "src/entrypoints/sdk/coreTypes.generated.ts",
+    "scripts/windows/openclaude-aliases.ps1",
+    "vendor/node-domexception-shim/",
+    "docs/windows-aliases-and-launchers.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "benchmark:startup": "node scripts/benchmark-openclaude-startup.mjs",
+    "integrations:generate": "bun run scripts/generate-integrations-artifacts.ts",
+    "integrations:check": "bun run scripts/generate-integrations-artifacts.ts --check",
+    "dev": "bun run build && node bin/openclaude",
+    "dev:profile": "bun run scripts/provider-launch.ts",
+    "dev:profile:fast": "bun run scripts/provider-launch.ts auto --fast --bare",
+    "dev:codex": "bun run scripts/provider-launch.ts codex",
+    "dev:openai": "bun run scripts/provider-launch.ts openai",
+    "dev:gemini": "bun run scripts/provider-launch.ts gemini",
+    "dev:ollama": "bun run scripts/provider-launch.ts ollama",
+    "dev:ollama:fast": "bun run scripts/provider-launch.ts ollama --fast --bare",
+    "dev:atomic-chat": "bun run scripts/provider-launch.ts atomic-chat",
+    "profile:init": "bun run scripts/provider-bootstrap.ts",
+    "profile:recommend": "bun run scripts/provider-recommend.ts",
+    "profile:auto": "bun run scripts/provider-recommend.ts --apply",
+    "profile:codex": "bun run profile:init -- --provider codex --model codexplan",
+    "profile:fast": "bun run profile:init -- --provider ollama --model llama3.2:3b",
+    "profile:code": "bun run profile:init -- --provider ollama --model qwen2.5-coder:7b",
+    "dev:fast": "bun run profile:fast && bun run dev:ollama:fast",
+    "dev:code": "bun run profile:code && bun run dev:profile",
+    "dev:grpc": "bun run scripts/start-grpc.ts",
+    "dev:grpc:cli": "bun run scripts/grpc-cli.ts",
+    "start": "node bin/openclaude",
+    "web:dev": "bun run --cwd web dev",
+    "web:build": "bun run --cwd web build",
+    "web:preview": "bun run --cwd web preview",
+    "web:typecheck": "bun run --cwd web typecheck",
+    "test": "bun test --feature=UNATTENDED_RETRY --max-concurrency=1",
+    "test:full": "bun test --feature=UNATTENDED_RETRY --max-concurrency=1 && bun run test:conversation-arc",
+    "test:conversation-arc": "bun test --feature=CONVERSATION_ARC --feature=MULTI_TURN_CONTEXT --max-concurrency=1 src/query.conversationArc.test.ts",
+    "test:coverage": "bun test --feature=UNATTENDED_RETRY --coverage --coverage-reporter=lcov --coverage-dir=coverage --max-concurrency=1 && bun run scripts/render-coverage-heatmap.ts",
+    "test:coverage:ui": "bun run scripts/render-coverage-heatmap.ts",
+    "security:pr-scan": "bun run scripts/pr-intent-scan.ts",
+    "test:provider-recommendation": "bun test src/utils/providerRecommendation.test.ts src/utils/providerProfile.test.ts",
+    "typecheck": "tsc --noEmit",
+    "typecheck:type-tests": "bun run scripts/typecheck-type-tests.ts",
+    "smoke": "bun run build && node dist/cli.mjs --version",
+    "deadcode": "knip --include files,dependencies",
+    "lint": "eslint .",
+    "lint:any-budget": "bun run scripts/any-usage-report.ts --check",
+    "check": "bun run lint:any-budget && bun run smoke && bun run deadcode && bun run test:full",
+    "check:strict": "bun run typecheck && bun run lint && bun run lint:any-budget && bun run smoke && bun run deadcode && bun run test:full",
+    "verify:privacy": "bun run scripts/verify-no-phone-home.ts",
+    "install:verify": "bun run scripts/verify-clean-install.ts",
+    "install:verify:published": "bun run scripts/verify-clean-install.ts --published",
+    "build:verified": "bun run build && bun run verify:privacy",
+    "test:provider": "bun test --feature=UNATTENDED_RETRY --max-concurrency=1 src/services/api/*.test.ts src/services/api/openaiShim/*.test.ts src/utils/context.test.ts",
+    "doctor:runtime": "bun run scripts/system-check.ts",
+    "doctor:runtime:json": "bun run scripts/system-check.ts --json",
+    "doctor:report": "bun run scripts/system-check.ts --out reports/doctor-runtime.json",
+    "hardening:check": "bun run smoke && bun run doctor:runtime",
+    "hardening:strict": "bun run typecheck && bun run hardening:check",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "@orama/orama": "3.1.18",
+    "@orama/plugin-data-persistence": "3.1.18",
+    "@vscode/ripgrep": "1.18.0"
+  },
+  "devDependencies": {
+    "@alcalzone/ansi-tokenize": "0.3.0",
+    "@anthropic-ai/bedrock-sdk": "0.29.1",
+    "@anthropic-ai/foundry-sdk": "0.2.3",
+    "@anthropic-ai/sandbox-runtime": "0.0.55",
+    "@anthropic-ai/sdk": "0.94.0",
+    "@aws-sdk/client-bedrock": "3.1047.0",
+    "@aws-sdk/client-sts": "3.1047.0",
+    "@aws-sdk/credential-provider-node": "3.972.41",
+    "@azure/identity": "^4.13.1",
+    "@commander-js/extra-typings": "12.1.0",
+    "@grpc/grpc-js": "^1.14.3",
+    "@grpc/proto-loader": "^0.8.0",
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "@sentry/node": "^10.70.0",
+    "@smithy/core": "3.24.3",
+    "@smithy/node-http-handler": "4.7.3",
+    "@types/bun": "1.3.11",
+    "@types/node": "25.5.0",
+    "@types/react": "19.2.14",
+    "@typescript-eslint/eslint-plugin": "^8.69.0",
+    "@typescript-eslint/parser": "^8.69.0",
+    "ajv": "8.18.0",
+    "auto-bind": "5.0.1",
+    "axios": "1.16.0",
+    "bidi-js": "1.0.3",
+    "chalk": "5.6.2",
+    "chokidar": "4.0.3",
+    "cli-boxes": "3.0.0",
+    "cli-highlight": "2.1.11",
+    "commander": "12.1.0",
+    "cross-spawn": "7.0.6",
+    "diff": "8.0.3",
+    "duck-duck-scrape": "^2.2.7",
+    "emoji-regex": "10.6.0",
+    "env-paths": "3.0.0",
+    "eslint": "9.39.5",
+    "execa": "9.6.1",
+    "fflate": "0.8.2",
+    "figures": "6.1.0",
+    "fuse.js": "7.1.0",
+    "get-east-asian-width": "1.5.0",
+    "google-auth-library": "10.6.2",
+    "graphology": "0.26.0",
+    "graphology-metrics": "2.4.0",
+    "https-proxy-agent": "7.0.6",
+    "ignore": "7.0.5",
+    "indent-string": "5.0.0",
+    "js-tiktoken": "1.0.21",
+    "jsonc-parser": "3.3.1",
+    "knip": "^6.16.1",
+    "lodash-es": "4.18.1",
+    "lru-cache": "11.2.7",
+    "marked": "15.0.12",
+    "p-map": "7.0.4",
+    "picomatch": "4.0.4",
+    "proper-lockfile": "4.1.2",
+    "qrcode": "1.5.4",
+    "react": "19.2.4",
+    "react-compiler-runtime": "1.0.0",
+    "react-reconciler": "0.33.0",
+    "semver": "7.7.4",
+    "sharp": "^0.34.5",
+    "shell-quote": "1.8.4",
+    "signal-exit": "4.1.0",
+    "supports-hyperlinks": "3.2.0",
+    "tree-kill": "1.2.2",
+    "tree-sitter-wasms": "0.1.13",
+    "turndown": "7.2.2",
+    "type-fest": "4.41.0",
+    "typescript": "5.9.3",
+    "undici": "7.28.0",
+    "usehooks-ts": "3.1.1",
+    "vscode-languageserver-protocol": "3.17.5",
+    "web-tree-sitter": "0.25.10",
+    "wrap-ansi": "9.0.2",
+    "ws": "8.21.0",
+    "xss": "1.0.15",
+    "yaml": "2.8.3",
+    "zod": "3.25.76"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": "^0.94.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "react": "^19.0.0",
+    "react-reconciler": "^0.33.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    },
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-reconciler": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Twigpine/openclaude.git"
+  },
+  "keywords": [
+    "claude-code",
+    "openai",
+    "llm",
+    "cli",
+    "agent",
+    "deepseek",
+    "ollama",
+    "gemini"
+  ],
   "license": "SEE LICENSE FILE",
-  "repository": { "type": "git", "url": "https://github.com/Twigpine/openclaude.git" }
+  "publishConfig": {
+    "access": "public"
+  },
+  "overrides": {
+    "ip-address": "10.2.0",
+    "google-auth-library": "10.6.2",
+    "lodash-es": "4.18.1",
+    "node-domexception": "file:vendor/node-domexception-shim"
+  },
+  "allowScripts": {
+    "protobufjs@7.6.4": true,
+    "sharp@0.34.5": true
+  }
 }

package/scripts/windows/openclaude-aliases.ps1

@@ -0,0 +1,206 @@
+Set-StrictMode -Version Latest
+
+function Test-OpenClaudeCommand {
+  [CmdletBinding()]
+  param(
+    [Parameter(Mandatory = $true)]
+    [string]$Name
+  )
+
+  return [bool](Get-Command -Name $Name -ErrorAction SilentlyContinue)
+}
+
+function Assert-OpenClaudeCommand {
+  [CmdletBinding()]
+  param(
+    [Parameter(Mandatory = $true)]
+    [string]$Name,
+    [Parameter(Mandatory = $true)]
+    [string]$InstallHint
+  )
+
+  if (-not (Test-OpenClaudeCommand -Name $Name)) {
+    throw "Required command '$Name' was not found. $InstallHint"
+  }
+}
+
+function Invoke-OpenClaude {
+  [CmdletBinding()]
+  param(
+    [Parameter(ValueFromRemainingArguments = $true)]
+    [string[]]$OpenClaudeArgs
+  )
+
+  Assert-OpenClaudeCommand -Name "openclaude" -InstallHint "Install with: npm install -g @twigpine/openclaude"
+
+  & openclaude @OpenClaudeArgs
+
+  if ($LASTEXITCODE -ne 0) {
+    throw "openclaude failed with exit code $LASTEXITCODE."
+  }
+}
+
+function Invoke-OpenClaudeWithEnvironment {
+  [CmdletBinding()]
+  param(
+    [Parameter(Mandatory = $true)]
+    [hashtable]$Environment,
+    [Parameter(ValueFromRemainingArguments = $true)]
+    [string[]]$OpenClaudeArgs
+  )
+
+  $previousValues = @{}
+
+  foreach ($name in $Environment.Keys) {
+    $previousValues[$name] = [Environment]::GetEnvironmentVariable($name, "Process")
+    Set-Item -Path "Env:$name" -Value $Environment[$name]
+  }
+
+  try {
+    Invoke-OpenClaude @OpenClaudeArgs
+  }
+  finally {
+    foreach ($name in $Environment.Keys) {
+      if ($null -eq $previousValues[$name]) {
+        Remove-Item -Path "Env:$name" -ErrorAction SilentlyContinue
+      }
+      else {
+        Set-Item -Path "Env:$name" -Value $previousValues[$name]
+      }
+    }
+  }
+}
+
+function Get-OpenClaudeQuickHelp {
+  [CmdletBinding()]
+  param()
+
+  @(
+    "OpenClaude quick commands:",
+    "  oc [args...]              -> launch OpenClaude using the installed CLI",
+    "  oc-local [args...]        -> launch OpenClaude with local/Ollama OpenAI-compatible environment hints for this invocation only",
+    "  oc-fast [args...]         -> launch OpenClaude with low-latency local defaults for this invocation only",
+    "  oc-provider               -> open the provider manager in OpenClaude",
+    "  oc-check                  -> show Ollama install/listening/model state",
+    "  oc-init                   -> pull/check the local model, then launch local/Ollama mode",
+    "  oc-help                   -> show this help"
+  ) -join [Environment]::NewLine
+}
+
+function oc {
+  [CmdletBinding()]
+  param(
+    [Parameter(ValueFromRemainingArguments = $true)]
+    [string[]]$OpenClaudeArgs
+  )
+
+  Invoke-OpenClaude @OpenClaudeArgs
+}
+
+function oc-local {
+  [CmdletBinding()]
+  param(
+    [string]$Model = "llama3.1:8b",
+    [Parameter(ValueFromRemainingArguments = $true)]
+    [string[]]$OpenClaudeArgs
+  )
+
+  Invoke-OpenClaudeWithEnvironment `
+    -Environment @{
+      CLAUDE_CODE_USE_OPENAI = "1"
+      OPENAI_BASE_URL        = "http://localhost:11434/v1"
+      OPENAI_MODEL           = $Model
+    } `
+    @OpenClaudeArgs
+}
+
+function oc-fast {
+  [CmdletBinding()]
+  param(
+    [string]$Model = "llama3.1:8b",
+    [Parameter(ValueFromRemainingArguments = $true)]
+    [string[]]$OpenClaudeArgs
+  )
+
+  Invoke-OpenClaudeWithEnvironment `
+    -Environment @{
+      CLAUDE_CODE_USE_OPENAI = "1"
+      OPENAI_BASE_URL        = "http://localhost:11434/v1"
+      OPENAI_MODEL           = $Model
+      OPENCLAUDE_FAST_MODE   = "1"
+    } `
+    @OpenClaudeArgs
+}
+
+function oc-provider {
+  [CmdletBinding()]
+  param()
+
+  Invoke-OpenClaude "/provider"
+}
+
+function oc-check {
+  [CmdletBinding()]
+  param(
+    [string]$Model = "llama3.1:8b"
+  )
+
+  Assert-OpenClaudeCommand -Name "ollama" -InstallHint "Install Ollama from https://ollama.com/download/windows."
+
+  $version = & ollama --version 2>$null
+  $modelNames = (& ollama list 2>$null | Select-Object -Skip 1 | ForEach-Object {
+      ($_ -split "\s+")[0]
+    }) | Where-Object { $_ }
+
+  $isModelAvailable = $modelNames -contains $Model
+  $probeSucceeded = $false
+
+  try {
+    $response = Invoke-RestMethod -Uri "http://localhost:11434/api/tags" -Method Get -TimeoutSec 3
+    if ($response.models) {
+      $probeSucceeded = $true
+    }
+  }
+  catch {
+    $probeSucceeded = $false
+  }
+
+  [PSCustomObject]@{
+    OllamaInstalled = $true
+    OllamaVersion   = $version
+    OllamaListening = $probeSucceeded
+    Model           = $Model
+    ModelAvailable  = $isModelAvailable
+  }
+}
+
+function oc-init {
+  [CmdletBinding()]
+  param(
+    [string]$Model = "llama3.1:8b",
+    [switch]$SkipModelPull
+  )
+
+  Assert-OpenClaudeCommand -Name "ollama" -InstallHint "Install Ollama from https://ollama.com/download/windows."
+
+  if (-not $SkipModelPull) {
+    & ollama pull $Model
+    if ($LASTEXITCODE -ne 0) {
+      throw "ollama pull $Model failed with exit code $LASTEXITCODE."
+    }
+  }
+
+  $health = oc-check -Model $Model
+  if (-not $health.OllamaListening) {
+    Write-Warning "Ollama is installed but API probe to localhost:11434 did not succeed. Start Ollama and retry."
+  }
+
+  oc-local -Model $Model
+}
+
+function oc-help {
+  [CmdletBinding()]
+  param()
+
+  Get-OpenClaudeQuickHelp
+}