Bytes CLI

The Bytes CLI creates, manages and organises workspace links from a terminal, script or trusted automation workflow.

It uses the public /api/v1 Developer API. It does not call browser-session routes, admin APIs or private dashboard endpoints.

Current scope

The CLI supports links, workspace tags, link tags, Activity Group lookup, Activity Group assignment and JSON output.

Install

npm install -g @jawwws/bytes-cli

Configure authentication

export BYTES_API_KEY="YOUR_BYTES_API_KEY"

Or store the key on a local machine you control:

bytes config set-api-key YOUR_BYTES_API_KEY

Resolve an Activity Group

bytes activity-groups list --slug blog
bytes activity-groups list --slug blog --json
bytes activity-groups list --type content --status active

Create and assign a link

bytes links create https://jawwws.com/blog/example \
  --slug jawwws-blog-example \
  --title "Example Jawwws article" \
  --channel social \
  --activity-group blog \
  --utm-source jawwws \
  --utm-medium blog

The --activity-group value can be a public Activity Group ID or slug.

When the group has a default UTM campaign and --utm-campaign is omitted, Bytes applies the group default. An explicit --utm-campaign takes precedence.

Update an assignment

bytes links update 01K0M4ZN8X7P9Q2R3S4T5V6W7X \
  --activity-group 01KYNVZSNW6Y56W2SHB4ZZ9QKE \
  --channel email

Repeating the same command reconciles the primary assignment without creating duplicate active items.

Link commands

bytes links list --per-page 10
bytes links get 01K0M4ZN8X7P9Q2R3S4T5V6W7X
bytes links update 01K0M4ZN8X7P9Q2R3S4T5V6W7X --inactive
bytes links archive 01K0M4ZN8X7P9Q2R3S4T5V6W7X --yes

Tag commands

bytes tags list
bytes tags create "Coffee tasting" --slug coffee-tasting
bytes tags update 01K0M5ABCD7EFGHJKMNPQRSTVW --description "Event links"
bytes tags delete 01K0M5ABCD7EFGHJKMNPQRSTVW --yes

Secure automation

Do not place API keys in browser JavaScript, public Vite or React environment variables, static HTML, source control, logs or screenshots.

For a static website, run the Bytes CLI in the private build or deployment process. Publish only the resulting https://jaww.ws/{slug} URL.

Package:

@jawwws/bytes-cli

Source:

https://github.com/jawwws/bytes-cli