oceancode 0.1.2 → 0.1.4

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 oceancode
-
-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/NOTICE

@@ -0,0 +1,9 @@
+OceanCode
+Copyright (c) 2026 OceanCode contributors
+
+This product includes software derived from OpenCode, Copyright (c) 2025 opencode,
+licensed under the MIT License. The original MIT license text is included in the
+LICENSE file in this repository.
+
+OceanCode is an independent project and is not affiliated with or endorsed by
+the OpenCode project or its maintainers.

package/README.md

@@ -1,42 +1,118 @@
-# OceanCode 🌊
-
-Next-generation CLI coding assistant powered by the OpenCode server backend.
-
-## Install
-
-Requires **Node.js 18+**.
-
-```bash
-npm install -g oceancode
-```
-
-This installs two commands — `oceancode` and its short alias `ocean` — plus the
-`opencode` backend binary (via the `opencode-ai` dependency), which the CLI
-manages automatically on first run. No other setup needed.
-
-## Usage
-
-```bash
-oceancode              # launch interactive chat
-ocean                  # same thing, shorter
-oceancode run "explain this repo and fix the failing build"
-oceancode run "add tests for the parser" -m gpt-4o --agent build
-```
-
-Slash commands inside interactive mode: `/init` `/goal` `/new` `/undo` `/redo`
-`/models` `/connect` `/mcp` `/diff` `/agent` `/compact` `/clear` `/info` `/help` `/exit`
-
-## How it works
-
-On startup the CLI spawns a local `opencode serve` backend (isolated on port
-4196 with its own config under `~/.config/oceancode`) and talks to it over HTTP/SSE.
-
-## Uninstall
-
-```bash
-npm uninstall -g oceancode
-```
-
-## License
-
-MIT
+<p align="center">
+  <a href="https://github.com/ianimatethings12-stack/oceancode">
+    <picture>
+      <source srcset="packages/web/src/assets/oceancode-logo-dark.svg" media="(prefers-color-scheme: dark)">
+      <source srcset="packages/web/src/assets/oceancode-logo-light.svg" media="(prefers-color-scheme: light)">
+      <img src="packages/web/src/assets/oceancode-logo-light.svg" alt="OceanCode logo">
+    </picture>
+  </a>
+</p>
+<p align="center">The open source AI coding agent.</p>
+<p align="center">
+  <a href="https://github.com/ianimatethings12-stack/oceancode/discussions"><img alt="Discord" src="https://img.shields.io/discord/1391832426048651334?style=flat-square&label=discord" /></a>
+  <a href="https://www.npmjs.com/package/oceancode"><img alt="npm" src="https://img.shields.io/npm/v/oceancode?style=flat-square" /></a>
+  <a href="https://github.com/ianimatethings12-stack/oceancode/actions/workflows/publish.yml"><img alt="Build status" src="https://img.shields.io/github/actions/workflow/status/ianimatethings12-stack/oceancode/publish.yml?style=flat-square&branch=dev" /></a>
+</p>
+
+<p align="center">
+  <a href="README.md">English</a> |
+  <a href="README.zh.md">简体中文</a> |
+  <a href="README.zht.md">繁體中文</a> |
+  <a href="README.ko.md">한국어</a> |
+  <a href="README.de.md">Deutsch</a> |
+  <a href="README.es.md">Español</a> |
+  <a href="README.fr.md">Français</a> |
+  <a href="README.it.md">Italiano</a> |
+  <a href="README.da.md">Dansk</a> |
+  <a href="README.ja.md">日本語</a> |
+  <a href="README.pl.md">Polski</a> |
+  <a href="README.ru.md">Русский</a> |
+  <a href="README.bs.md">Bosanski</a> |
+  <a href="README.ar.md">العربية</a> |
+  <a href="README.no.md">Norsk</a> |
+  <a href="README.br.md">Português (Brasil)</a> |
+  <a href="README.th.md">ไทย</a> |
+  <a href="README.tr.md">Türkçe</a> |
+  <a href="README.uk.md">Українська</a> |
+  <a href="README.bn.md">বাংলা</a> |
+  <a href="README.gr.md">Ελληνικά</a> |
+  <a href="README.vi.md">Tiếng Việt</a>
+</p>
+
+[![OceanCode Terminal UI](packages/web/src/assets/lander/screenshot.png)](https://github.com/ianimatethings12-stack/oceancode)
+
+---
+
+### Installation
+
+```bash
+# Install script
+curl -fsSL https://raw.githubusercontent.com/ianimatethings12-stack/oceancode/dev/install | bash
+
+# Package managers
+npm install -g oceancode@latest
+bun add -g oceancode@latest
+pnpm add -g oceancode@latest
+yarn global add oceancode@latest
+```
+
+> [!TIP]
+> Remove versions older than 0.1.x before installing.
+
+### Desktop App (BETA)
+
+OceanCode is also available as a desktop application. Download the unsigned v0.1 build from the [releases page](https://github.com/ianimatethings12-stack/oceancode/releases).
+
+| Platform              | Download                                  |
+| --------------------- | ----------------------------------------- |
+| macOS (Apple Silicon) | `oceancode-desktop-mac-arm64.dmg`         |
+| Windows               | `oceancode-desktop-windows-x64.exe`       |
+| Linux                 | `oceancode-desktop-linux-x64.AppImage`    |
+
+v0.1 desktop builds are unsigned and macOS Intel builds are not yet available. macOS may require right-click → Open, and Windows may show a SmartScreen warning.
+
+#### Installation Directory
+
+The install script respects the following priority order for the installation path:
+
+1. `$OCEANCODE_INSTALL_DIR` - Custom installation directory
+2. `$XDG_BIN_DIR` - XDG Base Directory Specification compliant path
+3. `$HOME/bin` - Standard user binary directory (if it exists or can be created)
+4. `$HOME/.oceancode/bin` - Default fallback
+
+```bash
+# Examples
+OCEANCODE_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/ianimatethings12-stack/oceancode/dev/install | bash
+XDG_BIN_DIR=$HOME/.local/bin curl -fsSL https://raw.githubusercontent.com/ianimatethings12-stack/oceancode/dev/install | bash
+```
+
+### Agents
+
+OceanCode includes two built-in agents you can switch between with the `Tab` key.
+
+- **build** - Default, full-access agent for development work
+- **plan** - Read-only agent for analysis and code exploration
+  - Denies file edits by default
+  - Asks permission before running bash commands
+  - Ideal for exploring unfamiliar codebases or planning changes
+
+Also included is a **general** subagent for complex searches and multistep tasks.
+This is used internally and can be invoked using `@general` in messages.
+
+Learn more about [agents](https://github.com/ianimatethings12-stack/oceancode/tree/dev/packages/web/src/content/docs/agents).
+
+### Documentation
+
+For more info on how to configure OceanCode, [**head over to our docs**](https://github.com/ianimatethings12-stack/oceancode/tree/dev/packages/web/src/content/docs).
+
+### Contributing
+
+If you're interested in contributing to OceanCode, please read our [contributing docs](./CONTRIBUTING.md) before submitting a pull request.
+
+### Building on OceanCode
+
+If you maintain a third-party project with "oceancode" in its name, for example "oceancode-dashboard" or "oceancode-mobile", please add a note to your README to clarify that it is not built by the OceanCode team and is not affiliated with us in any way.
+
+---
+
+**Join our community** [Discord](https://github.com/ianimatethings12-stack/oceancode/discussions) | [X.com](https://github.com/ianimatethings12-stack/oceancode)

package/bin/oceancode

@@ -0,0 +1,254 @@
+#!/usr/bin/env node
+
+import { createRequire } from "node:module"
+import { fileURLToPath } from "node:url"
+
+const require = createRequire(import.meta.url)
+const __filename = fileURLToPath(import.meta.url)
+
+const childProcess = require("child_process")
+const fs = require("fs")
+const path = require("path")
+const os = require("os")
+
+const forwardedSignals = ["SIGINT", "SIGTERM", "SIGHUP"]
+
+function run(target) {
+  const child = childProcess.spawn(target, process.argv.slice(2), {
+    stdio: "inherit",
+  })
+
+  child.on("error", (error) => {
+    console.error(error.message)
+    process.exit(1)
+  })
+
+  const forwarders = {}
+  for (const signal of forwardedSignals) {
+    forwarders[signal] = () => {
+      try {
+        child.kill(signal)
+      } catch {
+        // The child may have already exited.
+      }
+    }
+    process.on(signal, forwarders[signal])
+  }
+
+  child.on("exit", (code, signal) => {
+    for (const forwardedSignal of forwardedSignals) {
+      process.removeListener(forwardedSignal, forwarders[forwardedSignal])
+    }
+
+    if (signal) {
+      process.kill(process.pid, signal)
+      return
+    }
+
+    process.exit(typeof code === "number" ? code : 0)
+  })
+}
+
+const envPath = process.env.OCEANCODE_BIN_PATH || process.env.OCEAN_BIN_PATH || process.env.OPENCODE_BIN_PATH
+
+const scriptPath = fs.realpathSync(__filename)
+const scriptDir = path.dirname(scriptPath)
+
+const cached = path.join(scriptDir, ".oceancode")
+const legacyCached = [path.join(scriptDir, ".ocean"), path.join(scriptDir, ".opencode")]
+
+const platformMap = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows",
+}
+const archMap = {
+  x64: "x64",
+  arm64: "arm64",
+  arm: "arm",
+}
+
+let platform = platformMap[os.platform()]
+if (!platform) {
+  platform = os.platform()
+}
+let arch = archMap[os.arch()]
+if (!arch) {
+  arch = os.arch()
+}
+const base = "oceancode-" + platform + "-" + arch
+const binary = platform === "windows" ? "oceancode.exe" : "oceancode"
+
+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 cmd =
+      '(Add-Type -MemberDefinition "[DllImport(""kernel32.dll"")] public static extern bool IsProcessorFeaturePresent(int ProcessorFeature);" -Name Kernel32 -Namespace Win32 -PassThru)::IsProcessorFeaturePresent(40)'
+
+    for (const exe of ["powershell.exe", "pwsh.exe", "pwsh", "powershell"]) {
+      try {
+        const result = childProcess.spawnSync(exe, ["-NoProfile", "-NonInteractive", "-Command", cmd], {
+          encoding: "utf8",
+          timeout: 3000,
+          windowsHide: true,
+        })
+        if (result.status !== 0) continue
+        const out = (result.stdout || "").trim().toLowerCase()
+        if (out === "true" || out === "1") return true
+        if (out === "false" || out === "0") return false
+      } catch {
+        continue
+      }
+    }
+
+    return false
+  }
+
+  return false
+}
+
+const names = (() => {
+  const avx2 = supportsAvx2()
+  const baseline = arch === "x64" && !avx2
+
+  if (platform === "linux") {
+    const musl = (() => {
+      try {
+        if (fs.existsSync("/etc/alpine-release")) return true
+      } catch {
+        // ignore
+      }
+
+      try {
+        const result = childProcess.spawnSync("ldd", ["--version"], { encoding: "utf8" })
+        const text = ((result.stdout || "") + (result.stderr || "")).toLowerCase()
+        if (text.includes("musl")) return true
+      } catch {
+        // ignore
+      }
+
+      return false
+    })()
+
+    if (musl) {
+      if (arch === "x64") {
+        if (baseline) return [`${base}-baseline-musl`, `${base}-musl`, `${base}-baseline`, base]
+        return [`${base}-musl`, `${base}-baseline-musl`, base, `${base}-baseline`]
+      }
+      return [`${base}-musl`, base]
+    }
+
+    if (arch === "x64") {
+      if (baseline) return [`${base}-baseline`, base, `${base}-baseline-musl`, `${base}-musl`]
+      return [base, `${base}-baseline`, `${base}-musl`, `${base}-baseline-musl`]
+    }
+    return [base, `${base}-musl`]
+  }
+
+  if (arch === "x64") {
+    if (baseline) return [`${base}-baseline`, base]
+    return [base, `${base}-baseline`]
+  }
+  return [base]
+})()
+
+function findBinary(startDir) {
+  let current = startDir
+  for (;;) {
+    const modules = path.join(current, "node_modules")
+    if (fs.existsSync(modules)) {
+      for (const name of names) {
+        for (const candidateName of [name, name.replace(/^oceancode-/, "ocean-"), name.replace(/^oceancode-/, "opencode-")]) {
+          for (const candidateBinary of [binary, platform === "windows" ? "ocean.exe" : "ocean", platform === "windows" ? "opencode.exe" : "opencode"]) {
+            const candidate = path.join(modules, candidateName, "bin", candidateBinary)
+            if (fs.existsSync(candidate)) return candidate
+          }
+        }
+      }
+    }
+    const parent = path.dirname(current)
+    if (parent === current) {
+      return
+    }
+    current = parent
+  }
+}
+
+function findBun() {
+  const candidates = [
+    process.env.BUN_INSTALL ? path.join(process.env.BUN_INSTALL, "bin", process.platform === "windows" ? "bun.exe" : "bun") : null,
+    process.env.APPDATA ? path.join(process.env.APPDATA, "npm", "node_modules", "bun", "bin", "bun.exe") : null,
+    path.join(os.homedir(), ".bun", "bin", process.platform === "windows" ? "bun.exe" : "bun"),
+  ].filter(Boolean)
+
+  for (const c of candidates) {
+    if (fs.existsSync(c)) return c
+  }
+
+  try {
+    const out = childProcess.spawnSync(process.platform === "windows" ? "where.exe" : "which", ["bun"], {
+      encoding: "utf8",
+      timeout: 1000,
+    })
+    const lines = (out.stdout || "").trim().split(/\r?\n/).map((l) => l.trim()).filter(Boolean)
+    const exe = lines.find((l) => l.endsWith(".exe")) || lines[0]
+    if (exe) return exe
+  } catch {
+    // ignore
+  }
+
+  return process.platform === "windows" ? "bun.cmd" : "bun"
+}
+
+const devEntry = path.resolve(scriptDir, "../src/index.ts")
+const resolved =
+  envPath ||
+  (fs.existsSync(cached) ? cached : (legacyCached.find((candidate) => fs.existsSync(candidate)) ?? findBinary(scriptDir)))
+
+if (resolved) {
+  run(resolved)
+} else if (fs.existsSync(devEntry)) {
+  const bunCmd = findBun()
+  const child = childProcess.spawn(bunCmd, ["run", devEntry, ...process.argv.slice(2)], {
+    stdio: "inherit",
+    shell: bunCmd.endsWith(".cmd") || bunCmd.endsWith(".bat"),
+  })
+
+  child.on("error", (error) => {
+    console.error(error.message)
+    process.exit(1)
+  })
+
+  child.on("exit", (code) => {
+    process.exit(typeof code === "number" ? code : 0)
+  })
+} else {
+  console.error(
+    "It seems that your package manager failed to install the right version of the OceanCode CLI for your platform. You can try manually installing " +
+      names.map((n) => `\"${n}\"`).join(" or ") +
+      " package",
+  )
+  process.exit(1)
+}

package/package.json

@@ -1,51 +1,38 @@
 {
   "name": "oceancode",
-  "version": "0.1.2",
-  "description": "Next-generation CLI coding assistant powered by OpenCode server",
-  "main": "dist/index.js",
+  "version": "0.1.4",
+  "description": "OceanCode - an AI coding agent for the terminal, desktop, and IDE",
+  "license": "MIT",
+  "homepage": "https://github.com/ianimatethings12-stack/oceancode",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ianimatethings12-stack/oceancode"
+  },
   "bin": {
-    "oceancode": "dist/index.js",
-    "ocean": "dist/index.js"
+    "oceancode": "./bin/oceancode",
+    "ocean": "./bin/oceancode"
   },
-  "type": "module",
-  "files": [
-    "dist",
-    "scripts/postinstall.mjs",
-    "README.md",
-    "LICENSE"
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
   ],
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsx src/index.ts",
-    "start": "node dist/index.js",
-    "prepare": "npm run build",
-    "postinstall": "node ./scripts/postinstall.mjs",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "ai",
-    "cli",
-    "coding-assistant",
-    "opencode",
-    "oceancode"
+  "cpu": [
+    "arm64",
+    "x64"
   ],
-  "author": "",
-  "license": "MIT",
-  "dependencies": {
-    "@inquirer/prompts": "^7.3.2",
-    "chalk": "^5.4.1",
-    "commander": "^13.1.0",
-    "dotenv": "^16.4.7",
-    "opencode-ai": "^1.18.29",
-    "ora": "^8.2.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.13.5",
-    "tsup": "^8.4.0",
-    "tsx": "^4.19.3",
-    "typescript": "^5.7.3"
+  "optionalDependencies": {
+    "oceancode-windows-x64-baseline": "0.1.4",
+    "oceancode-windows-x64": "0.1.4",
+    "oceancode-windows-arm64": "0.1.4",
+    "oceancode-linux-x64-musl": "0.1.4",
+    "oceancode-linux-x64-baseline-musl": "0.1.4",
+    "oceancode-linux-x64-baseline": "0.1.4",
+    "oceancode-linux-x64": "0.1.4",
+    "oceancode-linux-arm64-musl": "0.1.4",
+    "oceancode-linux-arm64": "0.1.4",
+    "oceancode-darwin-x64-baseline": "0.1.4",
+    "oceancode-darwin-x64": "0.1.4",
+    "oceancode-darwin-arm64": "0.1.4"
   }
-}
+}