class-intercom

Class Intercom CLI

A self-contained CLI for Peninsula School District's Class Intercom (social media / school comms platform), generated with Printing Press from the live web app and hand-extended for PSD. Read-focused (content feed, channels, social feed, moderation, reports, tasks); the only write is create-draft, which can only create an unsent draft.

Built for PSD's Class Intercom workspace. Auth is your own browser session, so it works for whatever the authenticated account can access.

Setup (one-time)

1. Resolve the binary

The binary is not committed to the repo. Resolve it once — this downloads the prebuilt binary for your platform from the repo's GitHub Release (or builds it from cli/ if you have Go and no network):

BIN="$(bash scripts/ensure-binary.sh)"   # run from this skill's directory
"$BIN" --version

Use "$BIN" for every command below. It caches under ~/.cache/classintercom-pp-cli/, so this is a one-time cost.

2. Authenticate (Chrome cookie)

Auth is a Class Intercom session cookie read from Chrome. Install the cookie extractor once, then log in:

uv tool install pycookiecheat          # one-time; the CLI shells out to it
# Be logged into app.classintercom.com in Chrome, then:
"$BIN" auth login --chrome              # approve the macOS Keychain prompt if shown
"$BIN" auth status                      # should print "Authenticated"

Re-run auth login --chrome if the session expires.

Global flags

Every command supports --json, --csv, --compact, --agent (all agent-friendly defaults), --dry-run, and --select <fields>. Framework commands sync (mirror to local SQLite), search, and api (browse all endpoints) are also available.

Read commands

Channels

"$BIN" channels --json          # social channels with their UUIDs (value), network, label

The value field is the channel UUID you pass to create-draft --channel.

Content / activities (content <cmd>)