Connections

run auth linear                    # your own connection
run auth linear --scope billing    # a shared connection named "billing", for the whole org

Open this to connect linear:

  https://app.boxd.sh/integrations/connect/linear?org=…

Waiting for you to finish in the browser… (Ctrl-C to stop waiting)
✓ linear connected

run              # the integrations enabled for your team, and whether each is connected
run auth         # every connection: integration, scope, who connected it
run list         # connected integrations plus the catalog of what you can add (--all for the whole catalog)

$ run auth
TOOLKIT            SCOPE                BY               NOTE
linear             personal             Alice Example
github             scope: billing       Bob Example

run linear list-issues                     # your personal connection
run linear list-issues --scope billing     # the org's "billing" connection
run linear list-issues --scope             # list the scopes available to you

import { linear } from "@boxd/run";

const mine = await linear.listIssues({});                    // personal
const shared = await linear.scoped("billing").listIssues({}); // shared

run: list-issues failed: not connected: linear (personal)

Connect it here:

  https://app.boxd.sh/integrations/connect/linear?org=…

run: get-issue failed: not connected: linear - this is a SHARED machine, so it uses the team's shared connections, never a member's personal one

Connect it here:

  https://app.boxd.sh/integrations/connect/linear?org=…&scope=org-shared

run: list-issues failed: linear has 2 connections here and no default - re-run with --scope <name>: billing, ops

  --scope billing
  --scope ops

ssh myapp.boxd
git clone https://github.com/you/private-repo.git
gh pr create --fill

import { gh } from "@boxd/run";   // `github` and `gh` are the same integration

gh.on("issue-created", { owner: "acme", repo: "widgets" }, async (event) => {
  console.log("new issue", event.data.title);
});

import { githubApp } from "@boxd/run";

const gh = await githubApp.client();          // an authenticated Octokit
const { data } = await gh.rest.pulls.list({ owner: "acme", repo: "widgets" });

githubApp.on("pull_request.opened", { repo: "acme/widgets" }, async (pr) => {
  await gh.rest.issues.createComment({ owner: "acme", repo: "widgets", issue_number: pr.number, body: "on it" });
});