Documentation Index
Fetch the complete documentation index at: https://docs.usenotra.com/llms.txt
Use this file to discover all available pages before exploring further.
The Notra CLI gives you scriptable access to your workspace when installed. This repository currently does not include a CLI package, so treat these commands as the intended public CLI interface rather than local monorepo commands.
Install
You can also run any command without installing using bunx notra <command> or npx notra <command>.
Verify the install:
Authentication
The CLI authenticates with a Notra API key. You have three options.
Browser-based login
This opens the dashboard, has you confirm the new key, and writes it to local config.
Use notra auth login --no-browser on a remote machine to print the URL instead of opening a browser.
Paste an existing key
Prompts for your API key interactively, or pass it directly:
notra init --api-key ntra_xxxxxxxxxxxxxxxxxxxxxx
Per-command override
Skip stored config entirely with the NOTRA_API_KEY env var or a --api-key flag:
NOTRA_API_KEY=ntra_xxx notra posts list
notra posts list --api-key ntra_xxx
Configuration
Local config lives at ~/Library/Preferences/notra-cli-nodejs/config.json (macOS) or the platform equivalent.
notra config path
notra config get
notra config get api-key
notra config set base-url https://api.usenotra.com
notra config set api-key ntra_xxx
Quickstart
notra auth login
notra integrations github --owner usenotra --repo notra
notra brands generate --website-url https://usenotra.com --wait
notra posts generate --content-type changelog --lookback last_7_days --wait
notra posts list --status draft --limit 10
Posts
Manage generated content.
| Command | Description |
|---|
notra posts list | List posts in the current organization |
notra posts get <postId> | Fetch a single post |
notra posts generate | Queue an async post-generation job |
notra posts status <jobId> | Read the status of a generation job |
notra posts update <postId> | Update title, slug, markdown, or status |
notra posts delete <postId> | Delete a post |
List with filters
notra posts list --status draft --limit 10
notra posts list --content-type changelog,blog_post --sort desc
notra posts list --brand brand_abc --json
Read a post
notra posts get post_abc123
notra posts get post_abc123 --markdown > post.md
Generate content
notra posts generate \
--content-type changelog \
--brand brand_abc \
--github-integration integration_xyz \
--lookback last_7_days \
--wait
--wait polls until the job finishes. Drop it to return the jobId immediately and check later with notra posts status <jobId> --watch.
Update content
notra posts update post_abc123 --title "New title" --status published
notra posts update post_abc123 --markdown-file ./post.md
cat post.md | notra posts update post_abc123 --markdown-file -
Delete
notra posts delete post_abc123 --yes
Brand identities
Manage brand identities and run brand-identity generation jobs.
| Command | Description |
|---|
notra brands list | List brand identities |
notra brands get <brandId> | Fetch a single brand identity |
notra brands generate | Queue an async brand-identity generation from a website URL |
notra brands status <jobId> | Read the status of a brand-identity generation job |
notra brands update <brandId> | Update name, tone, instructions, or default flag |
notra brands delete <brandId> | Delete a non-default brand identity |
Generate from a website
notra brands generate --website-url https://acme.com --name Acme --wait
Update settings
notra brands update brand_abc --tone Professional
notra brands update brand_abc --custom-instructions "Always include PR links"
notra brands update brand_abc --default
Conversational, Professional, Casual, Formal.
Integrations
Connect GitHub repositories and manage existing Linear integrations. Slack is planned.
| Command | Description |
|---|
notra integrations list | List GitHub and Linear integrations |
notra integrations github | Connect a GitHub repository |
notra integrations remove <integrationId> | Disconnect a GitHub or Linear integration |
Connect a repository
notra integrations github --owner usenotra --repo notra
notra integrations github --owner acme --repo website --branch develop
notra integrations github --owner acme --repo private-app --token ghp_xxx
Schedules
Manage cron-based content-generation schedules.
| Command | Description |
|---|
notra schedules list | List schedules |
notra schedules create | Create a new schedule |
notra schedules update <scheduleId> | Replace a schedule (PATCH semantics) |
notra schedules delete <scheduleId> | Delete a schedule |
Create a schedule
notra schedules create \
--name "Daily changelog" \
--frequency daily --hour 9 --minute 0 \
--output-type changelog \
--repository repo_abc \
--lookback yesterday \
--enabled
--day-of-week (0-6) or --day-of-month (1-31).
From a JSON file
notra schedules create --config-file ./schedule.json
cat schedule.json | notra schedules create --config-file -
Global flags
These work on every command:
| Flag | Description |
|---|
--json | Print machine-readable JSON instead of a formatted table |
--api-key <value> | Override the configured key (or NOTRA_API_KEY env var) |
--base-url <value> | Override the API base URL (or NOTRA_BASE_URL env var) |
Pipe --json output through jq for scripting:notra posts list --status draft --json | jq -r '.posts[].id'
Source
The CLI is open source and lives alongside the rest of Notra. See the Notra GitHub repository for the source and to report issues.