@devboy-tools/cli

npm distribution of DevBoy tools — a fast, configurable tool bundle for AI coding agents, written in Rust. Use the same tools via an MCP server, via CLI commands, or directly from agent skills.

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

npm install @devboy-tools/cli
# or
pnpm add @devboy-tools/cli

Usage

DevBoy is a tool bundle — pick the mode that fits your workflow:

CLI (humans, CI, shell scripts)

# 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>

# Use tools directly
npx devboy issues
npx devboy mrs

MCP server (Claude Desktop, Claude Code, any MCP client)

# Start MCP server over stdio
npx devboy mcp

Agent skills (call a single tool from a skill script)

The tools call subcommand takes a tool name and an optional positional JSON string (defaults to {}). Quoting rules differ between shells:

# POSIX shells (bash, zsh, sh) — no args
npx devboy tools call get_issues

# POSIX shells — with JSON args
npx devboy tools call get_issues '{"limit": 20}'

:: Windows cmd.exe / PowerShell — escape inner quotes
npx devboy tools call get_issues "{\"limit\": 20}"

Claude Code

claude mcp add devboy -- npx devboy mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "devboy": {
      "command": "npx",
      "args": ["devboy", "mcp"]
    }
  }
}

Programmatic API

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"

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

npm rebuild @devboy-tools/cli

Unsupported platform

If your platform is not listed above, build from source:

cargo install --git https://github.com/meteora-pro/devboy-tools.git
export DEVBOY_BINARY_PATH=$(which devboy)

License

Apache License 2.0