--- slug: "devboy-tools" source_type: "readme" source_url: "https://cdn.jsdelivr.net/gh/meteora-pro/devboy-tools@main/README.md" repo: "https://github.com/meteora-pro/devboy-tools" source_file: "README.md" branch: "main" --- # DevBoy tools [![CI](https://github.com/meteora-pro/devboy-tools/actions/workflows/ci.yml/badge.svg)](https://github.com/meteora-pro/devboy-tools/actions/workflows/ci.yml) [![Codecov](https://codecov.io/gh/meteora-pro/devboy-tools/branch/main/graph/badge.svg)](https://codecov.io/gh/meteora-pro/devboy-tools) [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![npm](https://img.shields.io/npm/v/@devboy-tools/cli)](https://www.npmjs.com/package/@devboy-tools/cli) [![Ask Zread](https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000)](https://zread.ai/meteora-pro/devboy-tools) **A research-driven tool bundle for AI coding agents.** A single curated set of dev-workflow tools (GitHub, GitLab, Jira, ClickUp, Confluence, Slack, Fireflies) reachable from any agent — Claude Code, Copilot CLI, Codex, Cursor, Kimi, Gemini, … — through three transports: **MCP server**, **CLI**, or **installable agent skills**. Output goes through a token-aware pipeline that compresses responses by **26–69% per call** on the data-shape-friendly endpoints it targets (issues, pipelines, large lists) — see [paper 2 measurements](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/research/paper-2-mckp-format-adaptive.md) on a 144k-event production corpus. ```bash npm install -g @devboy-tools/cli # binary for your platform devboy onboard # detects your AI agent, installs the right skills ``` That's it. Verify with `devboy doctor`. --- ## Why DevBoy DevBoy isn't another aggregator with a long tool list. Four things that aren't standard elsewhere: - **Research-driven.** Every optimisation in the pipeline traces back to a paper grounded in a real corpus — 523 Claude Code sessions, 10,644 MCP tool responses. We don't ship a heuristic without measuring it. See [research index](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/research/INDEX.md). - **Three transports, one bundle.** The exact same tool set is reachable as MCP server, CLI for humans / CI, or as agent skills that call individual tools. Pick whichever fits today; layer the rest later. - **Privacy by default.** Tokens live in OS keychain (macOS Keychain / Windows Credential Manager / Linux Secret Service) with env-var fallback for CI. No cloud round-trip just to authenticate. - **Multi-project context.** One server, many project contexts (different GitHub/GitLab/Jira combinations), instant switch — no respawn, no config edit. Concrete: `devboy context use dashboard` and the same MCP session now talks to a different project's APIs. | | Generic MCP aggregator | DevBoy | |-|------------------------|--------| | **Output efficiency** | Default API JSON | Knapsack-based pagination + format-adaptive encoding ([papers 1, 2](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/research/INDEX.md)) — measured per-call savings on the 144k-event corpus: 69% avg on `get_issues`, 92% top per call, 26% avg on `*_pipeline`. KV-cache pass on Sonnet 4.5 lifts ~40% of tokens off the input side. | | **Tool catalogue** | Static | Dynamic per-project, with provider enrichers (custom field params, enum hints) | | **Transport** | MCP only | MCP, CLI, or agent skills — same tools | | **Onboarding** | Manual config + per-agent install | `devboy onboard` autodetects and bundles | | **Credentials** | Cloud / config files | OS keychain, env vars only as fallback | | **Extensibility** | Forking | Plugin system (Rust today; WASM, TypeScript planned) | --- ## Quick start (60 seconds) ```bash # 1. Install npm install -g @devboy-tools/cli # 2. Bootstrap — picks your agent + installs a curated skill bundle devboy onboard # 3. Configure your first provider (interactive) devboy init # 4. Verify devboy doctor ``` After this `devboy issues` returns your open tickets, your agent has the relevant skills loaded, and the MCP server is registered with whatever client you use. ### Install via plugin (Claude Code / Codex CLI) If you live inside Claude Code or Codex CLI, skip the npm step entirely. **Claude Code:** ```text /plugin marketplace add meteora-pro/devboy-tools /plugin install devboy@meteora-devboy ``` **Codex CLI** — reads the same `.claude-plugin/marketplace.json` (one of the four [official marketplace sources](https://developers.openai.com/codex/plugins/build)), so the install is symmetric: ```bash codex plugin marketplace add meteora-pro/devboy-tools codex plugin install devboy@meteora-devboy ``` Either way, the bundled `setup` skill installs the `devboy` CLI on first use (`npm install -g` with a SHA-256-verified GitHub Release tarball as fallback), wires up the MCP server, and runs `devboy onboard`. After the binary lands, run `/reload-plugins` (Claude Code) or restart your Codex session once. **OpenCode** and **Kimi CLI** users get the same skills for free — both auto-read `~/.claude/skills/`, so installing the Claude Code plugin or running `devboy onboard` covers them too. See the per-agent guides ([Claude Code](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/guide/integrations/claude-code-plugin.mdx), [Codex](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/guide/integrations/codex-plugin.mdx)) and [ADR-018](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/architecture/adr/ADR-018-plugin-distribution.md) for the architecture. If you'd rather pick everything by hand:
Manual install / configuration ```bash # Configure GitHub (replace gitlab/clickup/jira similarly) devboy config set github.owner meteora-pro devboy config set github.repo devboy-tools devboy config set-secret github.token # → OS keychain # Or via env vars (CI / Docker — keychain unavailable) export DEVBOY_GITHUB_TOKEN=ghp_... # Compatibility: GITHUB_TOKEN is read too # Pick skills explicitly instead of using a profile devboy skills list devboy skills install review-mr --agent claude devboy skills install --all --agent all ``` Build from source: ```bash git clone https://github.com/meteora-pro/devboy-tools.git cd devboy-tools && cargo build --release ./target/release/devboy --version ```
--- ## Skills & onboarding DevBoy ships a catalogue of **skills** — one-page Markdown recipes that tell an AI agent how to use the bundle to accomplish a common task. Skills are CLI-first (`devboy tools call ` under the hood), agent-agnostic (Claude Code / Codex / Cursor / Kimi or a vendor-neutral path), and versioned with the binary. `devboy onboard` is the fastest path: it scans `~/.claude/`, `~/.copilot/`, `~/.codex/`, `~/.kimi/`, Cursor's storage, `~/.gemini/`, and `~/.gemini/antigravity/`, scores each agent on freshness × volume (recency wins ties), and installs a profile-specific bundle. ```bash devboy onboard # auto-detect + install `dev` bundle devboy onboard --profile pm # PM bundle (issues + meetings + chat) devboy onboard --profile oncall # diagnostics + notifications devboy onboard --agent kimi --yes # explicit agent + non-interactive devboy agents list # show all detected agents with score ``` Three profiles ship today; categories below cover the full catalogue. | Category | Skills | |----------|--------| | `self-bootstrap` | `setup`, `repair`, `tools-catalog`, `pipeline-tune` | | `issue-tracking` | `get-issues`, `create-issue`, `update-issue`, `link-issues`, `solve-issue` | | `code-review` | `review-mr`, `fix-review-comments`, `self-review` | | `self-feedback` | `run-and-verify`, `daily-report`, `retro`, `knowledge-extract`, `qa-sweep`, `analyze-usage` | | `meeting-notes` | `meeting-search`, `meeting-transcript`, `meeting-to-tasks` | | `messenger` | `chat-search`, `chat-summary`, `notify` | Skill installs keep a per-location manifest with SHA-256s so upgrades leave user-modified files alone ([ADR-014](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/architecture/adr/ADR-014-skills-lifecycle.md)). Self-feedback skills read session traces from `.devboy/sessions/` ([ADR-015](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/architecture/adr/ADR-015-skills-session-traces.md)). **`analyze-usage`** is a featured skill that ships in two parts: a thin baseline (one Markdown file, embedded in the binary) plus a heavier Python backend (`~1 MB`, sparse-checked-out via curl on first use). It produces graphic monthly / weekly digests of how your AI sessions actually went — biome aquariums, 8-archetype bars, DORA radar, friction markers — plus shareable anonymised parquet bundles. See [`./.claude/skills/analyze-usage/`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/.claude/skills/analyze-usage/). --- ## Three integration modes The same tool set, three transports — pick what your workflow already uses. | Mode | When to use | Example | |------|-------------|---------| | **MCP server** | Claude Desktop, Claude Code, any MCP-compatible client | `devboy mcp` (stdio) | | **CLI** | Humans at the terminal, CI jobs, shell scripts | `devboy issues`, `devboy mrs`, `devboy tools call get_issues '{"limit": 20}'` | | **Agent skills** | Agents that don't want the full MCP tool-list tax — call only the tools a skill needs | `devboy tools call get_issues` from inside a skill script | > **JSON arguments tip.** `devboy tools call ` takes an optional positional JSON string (defaults to `{}`). POSIX shells: wrap in single quotes. Windows `cmd.exe`/PowerShell: escape inner quotes — `devboy tools call get_issues "{\"limit\": 20}"`. ### Claude Code The fastest way to get started is `devboy onboard` — it auto-detects which AI agent you actively use (by scanning `~/.claude/`, `~/.copilot/`, `~/.codex/`, `~/.kimi/`, Cursor's storage, `~/.gemini/`, `~/.gemini/antigravity/`) and installs a curated skill bundle for that agent: ```bash devboy onboard # detect primary agent, install the `dev` bundle devboy onboard --profile pm # PM bundle (issue tracking + meetings + messenger) devboy onboard --profile oncall # on-call bundle (diagnostics + notifications) devboy onboard --agent kimi --yes # explicit agent + non-interactive (CI / dotfiles) devboy agents list # show all detected agents with sessions / last-used / score ``` If you'd rather pick skills by hand: ```bash claude mcp add devboy -- devboy mcp claude mcp list ``` ### Claude Desktop `~/Library/Application Support/Claude/claude_desktop_config.json`: ```json { "mcpServers": { "devboy": { "command": "devboy", "args": ["mcp"] } } } ``` For Codex / Cursor / Kimi / Copilot CLI / Gemini CLI / Antigravity — `devboy onboard` autoconfigures the MCP entry; or follow the agent's docs for adding a stdio MCP server pointing at `devboy mcp`. --- ## Providers Seven provider plugins ship today — each with a dedicated client + schema enricher so the tool list adapts to your project's actual fields (custom fields, enum values, status taxonomies): | Provider | Crate | What you get | |----------|-------|--------------| | **GitHub** | [`devboy-github`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/plugins/api/github/) | Issues, pull requests, comments, branches, repos | | **GitLab** | [`devboy-gitlab`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/plugins/api/gitlab/) | Issues, merge requests, discussions, pipelines, MR diffs | | **Jira** | [`devboy-jira`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/plugins/api/jira/) | Issues with custom-field metadata, sprints, transitions, project versions (releases) | | **ClickUp** | [`devboy-clickup`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/plugins/api/clickup/) | Tasks, custom fields, lists, custom task IDs | | **Confluence** | [`devboy-confluence`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/plugins/api/confluence/) | Knowledge-base pages, search, spaces, create / update with labels (Server / Data Center, v1 + v2 API) | | **Slack** | [`devboy-slack`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/plugins/api/slack/) | Chat search, channel summary, post message | | **Fireflies** | [`devboy-fireflies`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/plugins/api/fireflies/) | Meeting transcripts, search, action items | Adding a provider is a Rust crate implementing `Provider` + a `ToolEnricher` ([ADR-007](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/architecture/adr/ADR-007-plugin-architecture.md)). --- ## Secret management Provider tokens, deploy keys, API tokens — `devboy-tools` ships a first-class secret framework so values never sit in plaintext config files and AI agents never see raw values. - **Manifest-driven** — projects declare required and optional secrets in `.devboy/secrets.toml` ([ADR-020](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/architecture/adr/ADR-020-secret-manifest-and-alias-resolution.md)). The merged inventory is the source of truth for `secrets list`, `doctor`, and the inventory view. - **Pluggable sources** — keychain, local-vault, 1Password, Vault (HTTP KV v2), env-store ship in-tree; community plugins extend the set via a stdio JSON-RPC subprocess protocol ([ADR-021](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/architecture/adr/ADR-021-secret-source-router.md)). - **Native UI** — TUI on ratatui + GUI on egui sharing one view-model layer; backend autodetected from `$DISPLAY`/`$WAYLAND_DISPLAY` ([ADR-023](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/architecture/adr/ADR-023-secret-store-ux-layer.md) §3.4). - **Agent-safe by construction** — MCP `secrets_*` tools return metadata only. Trust boundary is enforced by a marker trait, a CI grep gate, and a sentinel-based negative test (ADR-023 §3.7). - **Three deployment modes** — desktop (OS keychain), team (local-vault), CI (env-store). End-to-end smoke tests cover all three on every PR. Four guides for the framework live under [`docs/guide/secrets/`](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/guide/secrets/onboarding.md): - [Onboarding](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/guide/secrets/onboarding.md) — manual install → first source → manifest → validate → doctor. - [Local Vault](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/guide/secrets/local-vault.md) — file format, recovery flow, backup recommendations. - [Agent Protocol (MCP)](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/guide/secrets/agent-protocol.md) — every `secrets_*` tool, examples, the "no `secrets.get`" rule. - [Source Plugin Protocol](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/guide/secrets/source-plugin-protocol.md) — stdio JSON-RPC reference + working echo-source example in [`examples/secrets-source-echo/`](https://github.com/meteora-pro/devboy-tools/blob/main/examples/secrets-source-echo/). ```bash devboy secrets list # see what the active context expects devboy doctor --secrets # is everything provisioned? devboy secrets ui # TUI/GUI inventory devboy secrets rotate # opens provider URL + prompts for new value ``` For AI-driven setup, point the agent at the [`setup-secrets` skill](https://github.com/meteora-pro/devboy-tools/blob/HEAD/skills/00-self-bootstrap/setup-secrets/SKILL.md) — it walks the eight-step wizard with a state file at `~/.devboy/secrets/setup-state.toml`. --- ## Research Every non-trivial optimisation in the pipeline is backed by a paper grounded in a real corpus — 523 Claude Code sessions, 10,644 MCP responses from production traffic. The full [`docs/research/INDEX.md`](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/research/INDEX.md) tracks methods, datasets, and reproducibility scripts. | # | Paper | Status | Headline result | |---|-------|--------|-----------------| | [1](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/research/paper-1-trimtree.md) | TrimTree: priority-driven pagination — binary knapsack within a token budget, `p₁` metric | draft (820-line full draft, all experiments complete) | **3.3× p₁** vs uniform on power-law data; FIFO baseline 35% **replicated across 3 corpora**; KV-cache pass on Sonnet 4.5 ≈ **40% input-side savings** (66.5% hit rate) | | [2](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/research/paper-2-mckp-format-adaptive.md) | Format-adaptive tree encoding — multi-choice knapsack picking CSV / table / key:value per subtree | draft | Per-call savings on the corpus: **avg 69% on `get_issues`** (top 92%), **avg 26% on `*_pipeline`**; ≥ 20% bucket hits 1.25% of all events but most calls of the shape-friendly endpoints | | 3 ([theory](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/research/paper-3-context-enrichment.md) · [implementation](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/research/paper-3-tool-aware-enrichment.md)) | Context Enrichment Hypothesis + tool-aware knapsack with provider value models | draft (prefetch dispatcher merged in v0.22; production telemetry pending) | **Pearson r = −0.280** between `chars_per_item` and follow-up enrichment calls; thin issues (< 200 chars/item) → **43%** of turns add a `get_issue`; rich (1.5 k–4 k) → **2%** | | [4](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/research/paper-4-notebook-parquet.md) | Dataset-as-context — large responses become queryable Parquet artefacts the LLM pulls from | draft (early concept, no measurements yet) | Hypothesised **60–80% additional** savings on top of TrimTree; evaluation harness not yet built | Other corpus baselines used across papers (the 523 Claude Code sessions / 10,644 MCP-response sample, paper 1 §B): - `get_merge_request_diffs`: P90 = 35 k chars ≈ 10 k tokens — **28%** of responses exceed an 8 k-token budget - `get_epics`: P90 = 43 k chars ≈ 12 k tokens — 37% exceed budget - After overflow, agents always produce a text response on the next turn — they **never** retry / paginate (paper 1 §3, paper-1-trimtree.md:30 and §C) Paper 3's prefetch dispatcher already runs in the format pipeline; papers 1 and 2 land in the next minor version. Paper 4 is at concept stage — no production code yet. --- ## Architecture
Crate layout ``` crates/ ├── devboy-core/ Traits (Provider, ToolEnricher), shared types, config ├── devboy-executor/ Tool execution engine + enrichment pipeline ├── devboy-mcp/ MCP server (JSON-RPC over stdio) ├── devboy-cli/ CLI binary (`devboy`) ├── devboy-skills/ Skill catalogue, install/upgrade, manifests, traces ├── devboy-storage/ Credential storage (keychain, env vars) ├── devboy-assets/ File attachments (ADR-010) └── plugins/ ├── api/ { github, gitlab, jira, clickup, slack, fireflies } └── format-pipeline The token-aware output pipeline (papers 1, 2, 3) ```
Multi-project contexts One server, many contexts. Each context is its own provider config bundle: ``` ┌─ DevBoy MCP / CLI ────────────────┐ │ context: devboy-tools │ │ ├── GitHub: meteora-pro/devboy │ │ └── Slack: #devboy │ │ context: dashboard │ │ ├── GitLab: project #42 │ │ ├── ClickUp: list abc123 │ │ └── Jira: DEV │ └────────────────────────────────────┘ ``` Switch with `devboy context use ` (CLI) or the `use_context` tool (MCP). No respawn — the active session re-reads the new bindings on the next call.
Executor + enricher pipeline ``` Tool call → Executor 1. Enrichers transform args (e.g. cf_story_points → customFields) 2. Provider factory builds the client from ProviderConfig 3. Provider executes API calls → typed ToolOutput 4. Format pipeline encodes output → text (markdown / compact / json) ``` Three enricher categories, single `ToolEnricher` trait: - **Provider enrichers** — adapt schemas per provider (drop unsupported params, surface custom-field params, populate enums from project metadata). - **Pipeline enrichers** — add output-control parameters (`format` enum, pagination knobs). - **Custom enrichers** — third-party plugins. Architecture details: [executor](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/guide/architecture/executor.md), [enrichers](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/guide/architecture/enrichers.md), [format pipeline](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/guide/architecture/format-pipeline.md).
--- ## Documentation map - **Getting started** — [`docs/guide/getting-started/`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/docs/guide/getting-started/) - **CLI reference** (auto-generated) — [`docs/guide/reference/cli.md`](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/guide/reference/cli.md) - **Tool reference** (auto-generated) — [`docs/guide/reference/tools.md`](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/guide/reference/tools.md) - **Skills user guide** — [`docs/guide/skills/`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/docs/guide/skills/) - **Configuration** (env vars, contexts, doctor, proxy, format pipeline) — [`docs/guide/configuration/`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/docs/guide/configuration/) - **Secret management** (onboarding, local-vault, agent protocol, source plugins) — [`docs/guide/secrets/`](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/guide/secrets/onboarding.md) - **Architecture** — [`docs/guide/architecture/`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/docs/guide/architecture/) - **ADRs** — [`docs/architecture/adr/INDEX.md`](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/architecture/adr/INDEX.md) (18 decisions logged) - **Research papers** — [`docs/research/INDEX.md`](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/research/INDEX.md) - **Release procedure** — [`docs/guide/contributing/release.md`](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/guide/contributing/release.md) --- ## Use as a library Beyond the CLI, the workspace ships **library crates** on crates.io — embed devboy components directly in a Rust project. The catalogue covers the foundation, credential storage, the format pipeline, every API provider, the MCP server, the skills subsystem, and the CLI binary. | Crate | Description | Crates.io | Docs | |---|---|---|---| | [`devboy-core`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/devboy-core) | Provider traits, unified types, configuration, errors | [![Crates.io](https://img.shields.io/crates/v/devboy-core.svg)](https://crates.io/crates/devboy-core) | [![Docs](https://docs.rs/devboy-core/badge.svg)](https://docs.rs/devboy-core) | | [`devboy-storage`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/devboy-storage) | OS-keychain credential storage with `SecretString` plumbing | [![Crates.io](https://img.shields.io/crates/v/devboy-storage.svg)](https://crates.io/crates/devboy-storage) | [![Docs](https://docs.rs/devboy-storage/badge.svg)](https://docs.rs/devboy-storage) | | [`devboy-assets`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/devboy-assets) | On-disk asset cache with LRU rotation (ADR-010) | [![Crates.io](https://img.shields.io/crates/v/devboy-assets.svg)](https://crates.io/crates/devboy-assets) | [![Docs](https://docs.rs/devboy-assets/badge.svg)](https://docs.rs/devboy-assets) | | [`devboy-format-pipeline`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/plugins/format-pipeline) | TOON encoding, MCKP-budget trimming, cursor pagination | [![Crates.io](https://img.shields.io/crates/v/devboy-format-pipeline.svg)](https://crates.io/crates/devboy-format-pipeline) | [![Docs](https://docs.rs/devboy-format-pipeline/badge.svg)](https://docs.rs/devboy-format-pipeline) | | [`devboy-gitlab`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/plugins/api/gitlab) | GitLab provider (issues, merge requests) | [![Crates.io](https://img.shields.io/crates/v/devboy-gitlab.svg)](https://crates.io/crates/devboy-gitlab) | [![Docs](https://docs.rs/devboy-gitlab/badge.svg)](https://docs.rs/devboy-gitlab) | | [`devboy-github`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/plugins/api/github) | GitHub provider (issues, pull requests) | [![Crates.io](https://img.shields.io/crates/v/devboy-github.svg)](https://crates.io/crates/devboy-github) | [![Docs](https://docs.rs/devboy-github/badge.svg)](https://docs.rs/devboy-github) | | [`devboy-jira`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/plugins/api/jira) | Jira provider (issues, project versions) | [![Crates.io](https://img.shields.io/crates/v/devboy-jira.svg)](https://crates.io/crates/devboy-jira) | [![Docs](https://docs.rs/devboy-jira/badge.svg)](https://docs.rs/devboy-jira) | | [`devboy-clickup`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/plugins/api/clickup) | ClickUp provider | [![Crates.io](https://img.shields.io/crates/v/devboy-clickup.svg)](https://crates.io/crates/devboy-clickup) | [![Docs](https://docs.rs/devboy-clickup/badge.svg)](https://docs.rs/devboy-clickup) | | [`devboy-confluence`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/plugins/api/confluence) | Confluence (self-hosted) provider | [![Crates.io](https://img.shields.io/crates/v/devboy-confluence.svg)](https://crates.io/crates/devboy-confluence) | [![Docs](https://docs.rs/devboy-confluence/badge.svg)](https://docs.rs/devboy-confluence) | | [`devboy-fireflies`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/plugins/api/fireflies) | Fireflies meeting transcripts | [![Crates.io](https://img.shields.io/crates/v/devboy-fireflies.svg)](https://crates.io/crates/devboy-fireflies) | [![Docs](https://docs.rs/devboy-fireflies/badge.svg)](https://docs.rs/devboy-fireflies) | | [`devboy-slack`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/plugins/api/slack) | Slack provider | [![Crates.io](https://img.shields.io/crates/v/devboy-slack.svg)](https://crates.io/crates/devboy-slack) | [![Docs](https://docs.rs/devboy-slack/badge.svg)](https://docs.rs/devboy-slack) | | [`devboy-executor`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/devboy-executor) | Tool execution engine + provider factory | [![Crates.io](https://img.shields.io/crates/v/devboy-executor.svg)](https://crates.io/crates/devboy-executor) | [![Docs](https://docs.rs/devboy-executor/badge.svg)](https://docs.rs/devboy-executor) | | [`devboy-mcp`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/devboy-mcp) | MCP server (JSON-RPC 2.0 over stdio) | [![Crates.io](https://img.shields.io/crates/v/devboy-mcp.svg)](https://crates.io/crates/devboy-mcp) | [![Docs](https://docs.rs/devboy-mcp/badge.svg)](https://docs.rs/devboy-mcp) | | [`devboy-skills`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/devboy-skills) | Skills subsystem (SKILL.md parser, install lifecycle) | [![Crates.io](https://img.shields.io/crates/v/devboy-skills.svg)](https://crates.io/crates/devboy-skills) | [![Docs](https://docs.rs/devboy-skills/badge.svg)](https://docs.rs/devboy-skills) | | [`devboy-cli`](https://github.com/meteora-pro/devboy-tools/tree/HEAD/crates/devboy-cli) | The `devboy` CLI binary (npm is the primary channel) | [![Crates.io](https://img.shields.io/crates/v/devboy-cli.svg)](https://crates.io/crates/devboy-cli) | [![Docs](https://docs.rs/devboy-cli/badge.svg)](https://docs.rs/devboy-cli) | Example — embed a single provider: ```toml [dependencies] devboy-core = "0.26" devboy-jira = "0.26" ``` ```rust // Illustrative — not run automatically. use devboy_core::{Config, IssueProvider}; use devboy_jira::JiraClient; use secrecy::SecretString; async fn embed() -> anyhow::Result<()> { let cfg = Config::load()?; let jira_cfg = cfg.jira.expect("jira section missing in .devboy.toml"); // In a real devboy setup the token comes from the OS keychain via // `devboy_storage::ChainStore`; for an embedded host pass any // `SecretString` source you trust. let token: SecretString = std::env::var("JIRA_TOKEN")?.into(); let client = JiraClient::new( jira_cfg.url, jira_cfg.project_key, jira_cfg.email, token, ); let issue = client.get_issue("PROJ-123").await?; println!("{}", issue.key); Ok(()) } ``` The release procedure is documented in [`docs/guide/contributing/release.md`](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/guide/contributing/release.md). See [ADR-022](https://github.com/meteora-pro/devboy-tools/blob/HEAD/docs/architecture/adr/ADR-022-crates-io-publishing.md) for the architectural decision behind the dual npm + crates.io distribution. --- ## Development ```bash cargo build # debug build cargo test # runs the workspace test suite cargo clippy --all-targets # lint (CI uses RUSTFLAGS=-Dwarnings) cargo fmt --all # format cargo run -p devboy-cli -- doctor # smoke ``` The CLI reference is gated in CI: after touching `clap` definitions, run ```bash cargo run -p devboy-cli -- docs cli --output docs/guide/reference/cli.md ``` so the committed reference matches the binary. Same idea for `devboy tools docs` and the tool reference. See [CONTRIBUTING.md](https://github.com/meteora-pro/devboy-tools/blob/HEAD/CONTRIBUTING.md) for the full guide (commit conventions, branch naming, ADR workflow, release process). --- ## Community - **Issues / feature requests** — [GitHub Issues](https://github.com/meteora-pro/devboy-tools/issues) - **Design discussions** — [GitHub Discussions](https://github.com/meteora-pro/devboy-tools/discussions) - **Code review tooling** — open a PR; CI runs `Format`, `Clippy`, `Test` on macOS / Linux / Windows, `Coverage`, and the docs drift gate ## License [Apache License 2.0](https://github.com/meteora-pro/devboy-tools/tree/HEAD/LICENSE) — use it, modify it, ship it; if you build something interesting on top, we'd love a heads-up via Discussions.