Notra

Command-line interface for the Notra API.

Install

bun add -g notra
# or
npm i -g notra

Sign in

notra auth login

Opens the dashboard in your browser, asks you to pick an organization, mints an API key, and saves it locally. No copy-pasting tokens.

Commands

notra posts list
notra posts get <postId>
notra posts generate --content-type changelog --brand <id> --wait
notra brands list
notra integrations list
notra schedules list

Run notra <topic> --help to see every command and flag. Every command accepts --json for machine-readable output.

Config

The local config file lives at the OS-standard config path. Show it with:

notra config path

Environment overrides:

Var	Default	Purpose
NOTRA_API_KEY	–	API key for requests
NOTRA_BASE_URL	https://api.usenotra.com	API base URL
NOTRA_DASHBOARD_URL	https://app.usenotra.com	Dashboard used by auth login

Or persist them:

notra config set api-key sk_live_xxx
notra config set dashboard-url http://localhost:3000

Exit codes

Code	Meaning
0	Success
1	Generic failure
2	Usage error (bad flag, missing required)
3	Auth failure (no key, 401, 403)
4	Rate-limited (429)
5	Not found (404, missing resource)
6	Network failure

Develop

git clone https://github.com/usenotra/notra-cli && cd notra-cli
bun install
bun run dev -- posts list --help
bun run typecheck

Source is TypeScript with extensionless imports (moduleResolution: Bundler), executed directly by Bun via the dist/run.js shebang. No build step.