cli & api

CLI & API (planned)

A headless way to pull synced session profiles into CI — in development for the Pro tier.

What’s planned

A command-line tool that pulls an encrypted, synced session profile straight into your pipeline — no running browser required:

# Planned interface — subject to change
npx sessioncourier pull --profile staging --format storageState > auth.json

You’d authenticate the CLI against your synced profiles once, then any CI job can fetch a fresh, up-to-date session file at the start of its run.

Why it’s different

Existing cookie-manager APIs relay through a running browser — something has to have the extension open for the API to talk to. That works on your machine; it doesn’t work in a pipeline.

A synced-profile CLI is headless: the profile lives in encrypted sync, and the CLI pulls it directly. No browser in the CI image, no extension running anywhere — which is exactly the part CI needs.

Status

Not shipped yet. The CLI depends on encrypted sync, which is in development for the Pro tier. Until it lands, use the manual export + CI secret workflow — export locally, provide the file to CI as a secret or artifact. Join the waitlist to hear when the CLI is available.