@devboy-tools/cli 0.1.0

package/README.md

@@ -0,0 +1,105 @@
+# @devboy-tools/cli
+
+[![npm](https://img.shields.io/npm/v/@devboy-tools/cli)](https://www.npmjs.com/package/@devboy-tools/cli)
+[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+npm distribution of [DevBoy Tools](https://github.com/meteora-pro/devboy-tools) — a fast MCP server for coding agents, written in Rust.
+
+The correct binary for your platform is installed automatically via platform-specific packages.
+
+## Supported Platforms
+
+| OS      | Architecture | Package                      |
+|---------|-------------|------------------------------|
+| macOS   | ARM64       | `@devboy-tools/darwin-arm64` |
+| macOS   | x64         | `@devboy-tools/darwin-x64`   |
+| Linux   | x64         | `@devboy-tools/linux-x64`    |
+| Linux   | ARM64       | `@devboy-tools/linux-arm64`  |
+| Windows | x64         | `@devboy-tools/win32-x64`    |
+
+## Installation
+
+```bash
+npm install @devboy-tools/cli
+# or
+pnpm add @devboy-tools/cli
+```
+
+## Usage
+
+### CLI
+
+```bash
+# Start MCP server
+npx devboy mcp
+
+# Show help
+npx devboy --help
+
+# Configure a provider
+npx devboy config set github.owner <owner>
+npx devboy config set github.repo <repo>
+npx devboy config set-secret github.token <token>
+```
+
+### Claude Code
+
+```bash
+claude mcp add devboy -- npx devboy mcp
+```
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "devboy": {
+      "command": "npx",
+      "args": ["devboy", "mcp"]
+    }
+  }
+}
+```
+
+### Programmatic API
+
+```javascript
+const { getBinaryPath, name, version } = require("@devboy-tools/cli");
+
+console.log(getBinaryPath()); // /path/to/node_modules/@devboy-tools/darwin-arm64/bin/devboy
+console.log(name);            // "devboy"
+console.log(version);         // "0.3.0"
+```
+
+```typescript
+import { getBinaryPath, name, version } from "@devboy-tools/cli";
+```
+
+## Environment Variables
+
+| Variable             | Description                                      |
+|----------------------|--------------------------------------------------|
+| `DEVBOY_BINARY_PATH` | Override binary path (skips platform package resolution) |
+
+## Troubleshooting
+
+### Binary not found after install
+
+```bash
+npm rebuild @devboy-tools/cli
+```
+
+### Unsupported platform
+
+If your platform is not listed above, build from source:
+
+```bash
+cargo install --git https://github.com/meteora-pro/devboy-tools.git
+export DEVBOY_BINARY_PATH=$(which devboy)
+```
+
+## License
+
+[Apache License 2.0](https://github.com/meteora-pro/devboy-tools/blob/main/LICENSE)

package/bin/devboy-tools.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+"use strict";
+
+const { spawn } = require("child_process");
+const { getBinaryPath } = require("../index");
+
+let binaryPath;
+try {
+  binaryPath = getBinaryPath();
+} catch (err) {
+  console.error(err.message);
+  process.exit(1);
+}
+
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+});
+
+child.on("error", (err) => {
+  if (err.code === "ENOENT") {
+    console.error(
+      `devboy binary not found at: ${binaryPath}\n` +
+        "Run 'npm rebuild @devboy-tools/cli' or set DEVBOY_BINARY_PATH.",
+    );
+  } else {
+    console.error(`Failed to start devboy: ${err.message}`);
+  }
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code ?? 1);
+  }
+});
+
+// Forward signals to child process
+for (const sig of ["SIGINT", "SIGTERM"]) {
+  process.on(sig, () => {
+    if (!child.killed) {
+      child.kill(sig);
+    }
+  });
+}

package/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Returns the absolute path to the devboy binary.
+ *
+ * Resolution order:
+ * 1. `DEVBOY_BINARY_PATH` environment variable
+ * 2. Platform-specific npm package (`@devboy-tools/{platform}-{arch}`)
+ *
+ * @throws {Error} If the binary is not found at any location
+ */
+export declare function getBinaryPath(): string;
+
+/** Binary name: `"devboy"` */
+export declare const name: string;
+
+/** Package version (e.g. `"0.3.0"`) */
+export declare const version: string;

package/index.js

@@ -0,0 +1,59 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+
+const pkg = JSON.parse(
+  fs.readFileSync(path.join(__dirname, "package.json"), "utf8"),
+);
+
+/** Package name */
+exports.name = "devboy";
+
+/** Package version */
+exports.version = pkg.version;
+
+/**
+ * Returns the path to the devboy binary.
+ *
+ * Resolution order:
+ * 1. DEVBOY_BINARY_PATH environment variable
+ * 2. Platform-specific npm package (@devboy-tools/{platform}-{arch})
+ *
+ * @returns {string} Absolute path to the devboy binary
+ * @throws {Error} If binary is not found
+ */
+exports.getBinaryPath = function getBinaryPath() {
+  // 1. Environment variable override
+  const envPath = process.env.DEVBOY_BINARY_PATH;
+  if (envPath) {
+    if (!fs.existsSync(envPath)) {
+      throw new Error(
+        `DEVBOY_BINARY_PATH is set to "${envPath}" but the file does not exist.`,
+      );
+    }
+    return path.resolve(envPath);
+  }
+
+  // 2. Platform-specific package
+  const platformPkg = `@devboy-tools/${process.platform}-${process.arch}`;
+  const ext = process.platform === "win32" ? ".exe" : "";
+  const binaryName = `devboy${ext}`;
+
+  try {
+    const pkgJsonPath = require.resolve(`${platformPkg}/package.json`);
+    const binaryPath = path.join(path.dirname(pkgJsonPath), "bin", binaryName);
+    if (fs.existsSync(binaryPath)) {
+      return binaryPath;
+    }
+  } catch {
+    // Package not installed
+  }
+
+  throw new Error(
+    `devboy binary not found. No package ${platformPkg} installed.\n` +
+      "Your platform might not be supported. " +
+      "Set DEVBOY_BINARY_PATH to point to a devboy binary, or install from source:\n" +
+      "  cargo install --git https://github.com/meteora-pro/devboy-tools.git",
+  );
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@devboy-tools/cli",
+  "version": "0.1.0",
+  "description": "Fast and efficient MCP server for coding agents — npm wrapper for Rust binary",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/meteora-pro/devboy-tools.git",
+    "directory": "npm/devboy-tools"
+  },
+  "homepage": "https://github.com/meteora-pro/devboy-tools",
+  "bugs": {
+    "url": "https://github.com/meteora-pro/devboy-tools/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "devboy",
+    "code-review",
+    "ai-agent",
+    "gitlab",
+    "github",
+    "clickup",
+    "jira"
+  ],
+  "bin": {
+    "devboy": "bin/devboy-tools.js"
+  },
+  "main": "index.js",
+  "types": "index.d.ts",
+  "files": [
+    "bin/devboy-tools.js",
+    "index.js",
+    "index.d.ts"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@devboy-tools/darwin-arm64": "0.1.0",
+    "@devboy-tools/darwin-x64": "0.1.0",
+    "@devboy-tools/linux-arm64": "0.1.0",
+    "@devboy-tools/linux-x64": "0.1.0",
+    "@devboy-tools/win32-x64": "0.1.0"
+  }
+}