@wanghuimvp/axon 0.4.2 → 0.5.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Wade
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 opencode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,131 +1,10 @@
-# Axon
-
-A multi-provider agentic coding CLI. Axon runs a multi-step tool loop over your codebase — it reads, searches, edits, and runs commands to carry out a request — with an interactive chat or a one-shot non-interactive mode.
-
-> `0.x` — interactive TUI (`axon`) and non-interactive (`axon -p`), multi-provider (Anthropic / OpenAI + OpenAI-compatible / Gemini), read + write/edit/shell tools.
-
-## Install
-
-```bash
-npm install -g @wanghuimvp/axon
-```
-
-## Interactive mode
-
-Run `axon` with no arguments to open the interactive chat:
-
-```bash
-axon
-```
-
-On first run without an API key, `axon` opens a short setup screen — paste a key for the active provider and it is saved to `~/.axon/config.json` (with restricted file permissions) so later runs start straight in the chat. You can also set the provider's environment variable instead (e.g. `ANTHROPIC_API_KEY`), which always takes precedence.
-
-Axon reads your project on startup — `package.json` and the first of `AGENTS.md` / `CLAUDE.md` / `README.md` — and gives the model that context.
-
-Type a request and press Enter. Axon streams its reasoning and tool calls. When it wants to write a file or run a command, you get an inline prompt:
-
-```
-🔒 write_file({"path":"NOTES.md", …})
-[a] allow once / [A] always this session / [d] deny
-```
-
-Press `a` to allow once, `A` to allow that tool for the rest of the session, or `d` to deny (the model is told and adapts). `Ctrl+C` quits. Pass `--yolo` to skip all prompts.
-
-For one-shot, non-interactive use, see [Usage](#usage) (`axon -p`).
-
-## Providers
-
-Axon speaks to three backends. The OpenAI-compatible provider also drives any
-OpenAI-protocol endpoint (DeepSeek, Qwen, Kimi, Groq, OpenRouter, ollama, LM Studio, …)
-by pointing `baseUrl` at it.
-
-| Provider   | `provider` value | API key env         | Notes |
-|------------|------------------|---------------------|-------|
-| Anthropic  | `anthropic`      | `ANTHROPIC_API_KEY` | Claude models |
-| OpenAI     | `openai`         | `OPENAI_API_KEY`    | GPT + any OpenAI-compatible endpoint via `baseUrl` |
-| Gemini     | `gemini`         | `GEMINI_API_KEY`    | Google Gemini models |
-
-Set the relevant API key in your environment before running:
-
-```bash
-# macOS / Linux
-export OPENAI_API_KEY=sk-...
-# Windows (PowerShell)
-$env:OPENAI_API_KEY="sk-..."
-```
-
-### Select a provider/model
-
-```bash
-# Per run:
-axon --provider openai --model gpt-4.1 -p "explain engine.ts"
-
-# Persisted:
-axon config set provider gemini
-axon config set gemini.model gemini-2.5-pro
-axon config get
-```
-
-### Point at an OpenAI-compatible endpoint (e.g. DeepSeek, ollama)
-
-```bash
-axon config set provider openai
-axon config set openai.baseUrl https://api.deepseek.com/v1
-axon config set openai.model deepseek-chat
-export OPENAI_API_KEY=sk-...      # the endpoint's key
-axon -p "summarize src/"
-```
-
-For a local ollama server:
-```bash
-axon config set openai.baseUrl http://localhost:11434/v1
-axon config set openai.model qwen2.5-coder
-export OPENAI_API_KEY=ollama      # ollama ignores the key but the field must be non-empty
-```
-
-## Usage
-
-```bash
-axon -p "list the TypeScript files in src and explain what engine.ts does"
-```
-
-Axon will stream the model's reasoning, run read-only tools as needed (`read_file`, `list_dir`, `glob`, `grep`), and print the result.
-
-### Options
-
-- `-p, --print <prompt>` — run one prompt non-interactively and stream the result.
-- `--provider <name>` — select a provider (anthropic, openai, gemini) for this run.
-- `--model <name>` — select a model for this run.
-- `--yolo` — enable the `write_file`/`edit_file`/`shell` tools without prompting (non-interactive). Off by default: these tools are not even offered to the model, so it sticks to read-only inspection.
-- `--version` — print the version.
-
-### Changing files
-
-Axon can modify your workspace with `write_file`, `edit_file`, and run commands with `shell`. In non-interactive (`-p`) mode these tools are **only available with `--yolo`** — without the flag they are not offered to the model at all (and a permission gate denies them as defense-in-depth).
-
-```bash
-axon --yolo -p "add a CHANGELOG.md with an initial entry, then run the tests"
-```
-
-Read/search tools (`read_file`, `list_dir`, `glob`, `grep`) always run without a prompt. `write_file` and `edit_file` are confined to the project root (path-escape and symlink-escape protected). `shell` is **not** sandboxed — under `--yolo` it runs arbitrary commands and can affect anything your shell can. Only pass `--yolo` to runs you trust.
-
-## Configuration
-
-Optional config file at `~/.axon/config.json`:
-
-```json
-{
-  "provider": "anthropic",
-  "providers": {
-    "anthropic": { "model": "claude-opus-4-8" },
-    "openai":    { "model": "gpt-4.1", "baseUrl": "https://api.openai.com/v1" },
-    "gemini":    { "model": "gemini-2.5-pro" }
-  }
-}
-```
-
-API keys are read from environment variables (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GEMINI_API_KEY`) and never written to disk.
-
-## License
-
-MIT
+# axon
+
+A fast, open-source AI coding agent for the terminal — a rebranded fork of [opencode](https://github.com/anomalyco/opencode) (MIT).
+
+```bash
+npm i -g @wanghuimvp/axon
+axon --help
+```
+
+See the [project README](https://github.com/Wade-DevCode/axon) for install, usage, and configuration.

package/bin/axon.exe

@@ -0,0 +1,10 @@
+echo "Error: @wanghuimvp/axon's postinstall script was not run." >&2
+echo "" >&2
+echo "This occurs when using --ignore-scripts during installation, or when using a" >&2
+echo "package manager like pnpm that does not run postinstall scripts by default." >&2
+echo "" >&2
+echo "To fix this, run the postinstall script manually:" >&2
+echo "  cd node_modules/@wanghuimvp/axon && node postinstall.mjs" >&2
+echo "" >&2
+echo "Or reinstall @wanghuimvp/axon without the --ignore-scripts flag." >&2
+exit 1

package/package.json

@@ -1,63 +1,23 @@
-{
-  "name": "@wanghuimvp/axon",
-  "version": "0.4.2",
-  "description": "Axon — a multi-provider agentic coding CLI (Anthropic, OpenAI + OpenAI-compatible endpoints, Gemini). Runs a multi-step tool loop over your codebase.",
-  "type": "module",
-  "bin": {
-    "axon": "dist/cli.js"
-  },
-  "files": [
-    "dist"
-  ],
-  "engines": {
-    "node": ">=20"
-  },
-  "license": "MIT",
-  "keywords": [
-    "cli",
-    "agent",
-    "agentic",
-    "coding",
-    "anthropic",
-    "claude",
-    "ai",
-    "assistant",
-    "axon"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Wade-DevCode/axon.git"
-  },
-  "homepage": "https://github.com/Wade-DevCode/axon#readme",
-  "bugs": {
-    "url": "https://github.com/Wade-DevCode/axon/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "dev": "tsx src/cli.ts",
-    "test": "vitest run",
-    "build": "esbuild src/cli.ts --bundle --platform=node --format=esm --outfile=dist/cli.js --packages=external --jsx=automatic",
-    "prepublishOnly": "npm test && npm run build"
-  },
-  "dependencies": {
-    "@anthropic-ai/sdk": "^0.40.0",
-    "@google/genai": "^1.52.0",
-    "commander": "^12.0.0",
-    "fast-glob": "^3.3.0",
-    "ink": "^5.2.1",
-    "ink-text-input": "^6.0.0",
-    "openai": "^4.104.0",
-    "react": "^18.3.1"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/react": "^18.3.31",
-    "esbuild": "^0.23.0",
-    "ink-testing-library": "^4.0.0",
-    "tsx": "^4.0.0",
-    "typescript": "^5.5.0",
-    "vitest": "^2.0.0"
-  }
-}
+{
+  "name": "@wanghuimvp/axon",
+  "bin": {
+    "axon": "./bin/axon.exe"
+  },
+  "scripts": {
+    "postinstall": "node ./postinstall.mjs"
+  },
+  "version": "0.5.0",
+  "license": "MIT",
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ],
+  "optionalDependencies": {
+    "axon-windows-x64": "0.5.0"
+  }
+}

package/postinstall.mjs

@@ -0,0 +1,189 @@
+#!/usr/bin/env node
+
+import childProcess from "child_process"
+import fs from "fs"
+import os from "os"
+import path from "path"
+import { createRequire } from "module"
+import { fileURLToPath } from "url"
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const require = createRequire(import.meta.url)
+const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, "package.json"), "utf8"))
+
+const platformMap = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows",
+}
+const archMap = {
+  x64: "x64",
+  arm64: "arm64",
+  arm: "arm",
+}
+
+const platform = platformMap[os.platform()] ?? os.platform()
+const arch = archMap[os.arch()] ?? os.arch()
+const base = `axon-${platform}-${arch}`
+const sourceBinary = platform === "windows" ? "axon.exe" : "axon"
+const targetBinary = path.join(__dirname, "bin", "axon.exe")
+
+function supportsAvx2() {
+  if (arch !== "x64") return false
+
+  if (platform === "linux") {
+    try {
+      return /(^|\s)avx2(\s|$)/i.test(fs.readFileSync("/proc/cpuinfo", "utf8"))
+    } catch {
+      return false
+    }
+  }
+
+  if (platform === "darwin") {
+    try {
+      const result = childProcess.spawnSync("sysctl", ["-n", "hw.optional.avx2_0"], {
+        encoding: "utf8",
+        timeout: 1500,
+      })
+      if (result.status !== 0) return false
+      return (result.stdout || "").trim() === "1"
+    } catch {
+      return false
+    }
+  }
+
+  if (platform === "windows") {
+    const command =
+      '(Add-Type -MemberDefinition "[DllImport(""kernel32.dll"")] public static extern bool IsProcessorFeaturePresent(int ProcessorFeature);" -Name Kernel32 -Namespace Win32 -PassThru)::IsProcessorFeaturePresent(40)'
+
+    for (const executable of ["powershell.exe", "pwsh.exe", "pwsh", "powershell"]) {
+      try {
+        const result = childProcess.spawnSync(executable, ["-NoProfile", "-NonInteractive", "-Command", command], {
+          encoding: "utf8",
+          timeout: 3000,
+          windowsHide: true,
+        })
+        if (result.status !== 0) continue
+        const output = (result.stdout || "").trim().toLowerCase()
+        if (output === "true" || output === "1") return true
+        if (output === "false" || output === "0") return false
+      } catch {
+        continue
+      }
+    }
+  }
+
+  return false
+}
+
+function isMusl() {
+  if (platform !== "linux") return false
+
+  try {
+    if (fs.existsSync("/etc/alpine-release")) return true
+  } catch {
+    // Ignore filesystem probes that are blocked by the host.
+  }
+
+  try {
+    const result = childProcess.spawnSync("ldd", ["--version"], { encoding: "utf8" })
+    return `${result.stdout || ""}${result.stderr || ""}`.toLowerCase().includes("musl")
+  } catch {
+    return false
+  }
+}
+
+function packageNames() {
+  const baseline = arch === "x64" && !supportsAvx2()
+
+  if (platform === "linux") {
+    if (isMusl()) {
+      if (arch === "x64")
+        return baseline
+          ? [`${base}-baseline-musl`, `${base}-musl`, `${base}-baseline`, base]
+          : [`${base}-musl`, `${base}-baseline-musl`, base, `${base}-baseline`]
+      return [`${base}-musl`, base]
+    }
+
+    if (arch === "x64")
+      return baseline
+        ? [`${base}-baseline`, base, `${base}-baseline-musl`, `${base}-musl`]
+        : [base, `${base}-baseline`, `${base}-musl`, `${base}-baseline-musl`]
+    return [base, `${base}-musl`]
+  }
+
+  if (arch === "x64") return baseline ? [`${base}-baseline`, base] : [base, `${base}-baseline`]
+  return [base]
+}
+
+function resolveBinary(name) {
+  const packageJsonPath = require.resolve(`${name}/package.json`)
+  const binaryPath = path.join(path.dirname(packageJsonPath), "bin", sourceBinary)
+  if (!fs.existsSync(binaryPath)) throw new Error(`Binary not found at ${binaryPath}`)
+  return binaryPath
+}
+
+function installPackage(name) {
+  const version = packageJson.optionalDependencies?.[name]
+  if (!version) return
+
+  const temp = fs.mkdtempSync(path.join(os.tmpdir(), "axon-install-"))
+  try {
+    const result = childProcess.spawnSync(
+      "npm",
+      ["install", "--ignore-scripts", "--no-save", "--loglevel=error", "--prefix", temp, `${name}@${version}`],
+      { stdio: "inherit", windowsHide: true },
+    )
+    if (result.status !== 0) return
+    const packageDir = path.join(temp, "node_modules", name)
+    copyBinary(path.join(packageDir, "bin", sourceBinary), targetBinary)
+    return true
+  } finally {
+    fs.rmSync(temp, { recursive: true, force: true })
+  }
+}
+
+function copyBinary(source, target) {
+  if (!fs.existsSync(source)) throw new Error(`Binary not found at ${source}`)
+  fs.mkdirSync(path.dirname(target), { recursive: true })
+  if (fs.existsSync(target)) fs.unlinkSync(target)
+  try {
+    fs.linkSync(source, target)
+  } catch {
+    fs.copyFileSync(source, target)
+  }
+  fs.chmodSync(target, 0o755)
+}
+
+function verifyBinary() {
+  const result = childProcess.spawnSync(targetBinary, ["--version"], {
+    encoding: "utf8",
+    stdio: "ignore",
+    windowsHide: true,
+  })
+  return result.status === 0
+}
+
+function main() {
+  for (const name of packageNames()) {
+    try {
+      copyBinary(resolveBinary(name), targetBinary)
+      if (verifyBinary()) return
+    } catch {
+      if (installPackage(name) && verifyBinary()) return
+    }
+  }
+
+  throw new Error(
+    `It seems your package manager failed to install the right axon CLI package. Try manually installing ${packageNames()
+      .map((name) => JSON.stringify(name))
+      .join(" or ")}.`,
+  )
+}
+
+try {
+  main()
+} catch (error) {
+  console.error(error.message)
+  process.exit(1)
+}