pertrellyclaude 0.1.7

package/README.md

@@ -0,0 +1,193 @@
+# OpenClaude
+
+Use Claude Code with **any LLM** — not just Claude.
+
+OpenClaude lets you use Claude Code with any LLM through an OpenAI-compatible API shim. Plug in GPT-4o, DeepSeek, Gemini, Llama, Mistral, or any model that speaks the OpenAI chat completions API. It also supports the ChatGPT Codex backend for `codexplan` and `codexspark`, and local inference via [Atomic Chat](https://atomic.chat/) on Apple Silicon.
+
+All of Claude Code's tools work — bash, file read/write/edit, grep, glob, agents, tasks, MCP — just powered by whatever model you choose.
+
+---
+
+## Start Here
+
+If you are new to terminals or just want the easiest path, start with the beginner guides:
+
+- [Non-Technical Setup](docs/non-technical-setup.md)
+- [Windows Quick Start](docs/quick-start-windows.md)
+- [macOS / Linux Quick Start](docs/quick-start-mac-linux.md)
+
+If you want source builds, Bun workflows, profile launchers, or full provider examples, use:
+
+- [Advanced Setup](docs/advanced-setup.md)
+
+---
+
+## Install
+
+Clone the repository and build:
+
+```bash
+git clone https://github.com/Izaiaspertrelly/openclaude.git
+cd openclaude
+npm install
+npm run build
+```
+
+Then run:
+
+```bash
+npm start
+# or
+node bin/openclaude
+```
+
+If you install via npm and later see `ripgrep not found`, install ripgrep system-wide and confirm `rg --version` works in the same terminal before starting OpenClaude.
+
+---
+
+## Fastest Setup
+
+### Windows PowerShell
+
+```powershell
+git clone https://github.com/Izaiaspertrelly/openclaude.git
+cd openclaude
+npm install && npm run build
+
+$env:CLAUDE_CODE_USE_OPENAI="1"
+$env:OPENAI_API_KEY="sk-your-key-here"
+$env:OPENAI_MODEL="gpt-4o"
+
+openclaude
+```
+
+### macOS / Linux
+
+```bash
+git clone https://github.com/Izaiaspertrelly/openclaude.git
+cd openclaude
+npm install && npm run build
+
+export CLAUDE_CODE_USE_OPENAI=1
+export OPENAI_API_KEY=sk-your-key-here
+export OPENAI_MODEL=gpt-4o
+
+openclaude
+```
+
+That is enough to start with OpenAI.
+
+---
+
+## Choose Your Guide
+
+### Beginner
+
+- Want the easiest setup with copy-paste steps: [Non-Technical Setup](docs/non-technical-setup.md)
+- On Windows: [Windows Quick Start](docs/quick-start-windows.md)
+- On macOS or Linux: [macOS / Linux Quick Start](docs/quick-start-mac-linux.md)
+
+### Advanced
+
+- Want source builds, Bun, local profiles, runtime checks, or more provider choices: [Advanced Setup](docs/advanced-setup.md)
+
+---
+
+## Common Beginner Choices
+
+### OpenAI
+
+Best default if you already have an OpenAI API key.
+
+### Ollama
+
+Best if you want to run models locally on your own machine.
+
+### Codex
+
+Best if you already use the Codex CLI or ChatGPT Codex backend.
+
+### Atomic Chat
+
+Best if you want local inference on Apple Silicon with Atomic Chat. See [Advanced Setup](docs/advanced-setup.md).
+
+---
+
+## What Works
+
+- **All tools**: Bash, FileRead, FileWrite, FileEdit, Glob, Grep, WebFetch, WebSearch, Agent, MCP, LSP, NotebookEdit, Tasks
+- **Streaming**: Real-time token streaming
+- **Tool calling**: Multi-step tool chains (the model calls tools, gets results, continues)
+- **Images**: Base64 and URL images passed to vision models
+- **Slash commands**: /commit, /review, /compact, /diff, /doctor, etc.
+- **Sub-agents**: AgentTool spawns sub-agents using the same provider
+- **Memory**: Persistent memory system
+
+## What's Different
+
+- **No thinking mode**: Anthropic's extended thinking is disabled (OpenAI models use different reasoning)
+- **No prompt caching**: Anthropic-specific cache headers are skipped
+- **No beta features**: Anthropic-specific beta headers are ignored
+- **Token limits**: Defaults to 32K max output — some models may cap lower, which is handled gracefully
+
+---
+
+## How It Works
+
+The shim (`src/services/api/openaiShim.ts`) sits between Claude Code and the LLM API:
+
+```
+Claude Code Tool System
+        |
+        v
+  Anthropic SDK interface (duck-typed)
+        |
+        v
+  openaiShim.ts  <-- translates formats
+        |
+        v
+  OpenAI Chat Completions API
+        |
+        v
+  Any compatible model
+```
+
+It translates:
+- Anthropic message blocks → OpenAI messages
+- Anthropic tool_use/tool_result → OpenAI function calls
+- OpenAI SSE streaming → Anthropic stream events
+- Anthropic system prompt arrays → OpenAI system messages
+
+The rest of Claude Code doesn't know it's talking to a different model.
+
+---
+
+## Model Quality Notes
+
+Not all models are equal at agentic tool use. Here's a rough guide:
+
+| Model | Tool Calling | Code Quality | Speed |
+|-------|-------------|-------------|-------|
+| GPT-4o | Excellent | Excellent | Fast |
+| DeepSeek-V3 | Great | Great | Fast |
+| Gemini 2.0 Flash | Great | Good | Very Fast |
+| Llama 3.3 70B | Good | Good | Medium |
+| Mistral Large | Good | Good | Fast |
+| GPT-4o-mini | Good | Good | Very Fast |
+| Qwen 2.5 72B | Good | Good | Medium |
+| Smaller models (<7B) | Limited | Limited | Very Fast |
+
+For best results, use models with strong function/tool calling support.
+
+---
+
+## About
+
+OpenClaude is provided for educational and research purposes.
+
+
+---
+
+## License
+
+This repository is provided for educational and research purposes. The original source code is subject to Anthropic's terms. The OpenAI shim additions are public domain.

package/bin/import-specifier.mjs

@@ -0,0 +1,7 @@
+import { join } from 'path'
+import { pathToFileURL } from 'url'
+
+export function getDistImportSpecifier(baseDir) {
+  const distPath = join(baseDir, '..', 'dist', 'cli.mjs')
+  return pathToFileURL(distPath).href
+}

package/bin/import-specifier.test.mjs

@@ -0,0 +1,13 @@
+import assert from 'node:assert/strict'
+import test from 'node:test'
+
+import { getDistImportSpecifier } from './import-specifier.mjs'
+
+test('builds a file URL import specifier for dist/cli.mjs', () => {
+  const specifier = getDistImportSpecifier('C:\\repo\\bin')
+
+  assert.equal(
+    specifier,
+    'file:///C:/repo/dist/cli.mjs',
+  )
+})

package/bin/openclaude

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+/**
+ * OpenClaude — Claude Code with any LLM
+ *
+ * If dist/cli.mjs exists (built), run that.
+ * Otherwise, tell the user to build first or use `bun run dev`.
+ */
+
+import { existsSync } from 'fs'
+import { join, dirname } from 'path'
+import { fileURLToPath, pathToFileURL } from 'url'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const distPath = join(__dirname, '..', 'dist', 'cli.mjs')
+
+if (existsSync(distPath)) {
+  await import(pathToFileURL(distPath).href)
+} else {
+  console.error(`
+  openclaude: dist/cli.mjs not found.
+
+  Build first:
+    bun run build
+
+  Or run directly with Bun:
+    bun run dev
+
+  See README.md for setup instructions.
+`)
+  process.exit(1)
+}