Skip to main content
pinbox link creates an item in an external tracker and stores a persistent two-way link. From then on, thread messages are mirrored in both directions. Reach for it when a pin needs to live where the rest of your team already works.

Usage

Arguments

string
required
Pin id (pin_xxxxxxxxxx). Ids are exact — prefixes do not match.
string
default:"github"
Tracker connector. See the table below for what ships and what each one needs.

Options

boolean
Machine output: the {"ok":true,"data":…} envelope.

Connectors

Two connectors ship today. The hub only offers one when its requirements are met. pinbox doctor reports the gh half.

Examples

On success, stdout carries the created item as <connector>#<ref> followed by its URL, and stderr confirms the link. For a GitHub issue #41 in acme/storefront:

JSON

data is the full updated pin — the same shape pinbox show returns — with the new link appended to links[]:
Failures follow the same envelope. hint is absent when the connector’s own error message is already the whole story:

Errors

When gh is the problem, the hint names the fix directly: install GitHub CLI and run gh auth login if it is missing, or just gh auth login if it is installed but logged out.
Next: check links[] with pinbox show, or confirm gh is usable with pinbox doctor.