CLI Reference

Complete reference for the Supacortex CLI (scx).

The Supacortex CLI (scx) gives you full access to your memory from the terminal. Install it with npm install -g @supacortex/cli.

Authentication

Authenticate via browser. Opens a device code flow — approve in your browser and the CLI saves your credentials locally.

scx login

`scx logout`

Remove saved credentials.

scx logout

`scx token <apikey>`

Manually set an API key instead of using the browser login flow.

scx token sk_live_abc123

`scx whoami`

Show current configuration — endpoint and API key status.

scx whoami

`scx endpoint [url]`

Show, set, or reset the API endpoint. Useful for self-hosted instances.

scx endpoint                          # Show current
scx endpoint https://my-server.com/api  # Set custom
scx endpoint reset                    # Reset to default

Bookmarks

`scx bookmarks list`

List bookmarks with optional filtering.

scx bookmarks list [options]

Option	Description
`-l, --limit <number>`	Max results (default: 20)
`-o, --offset <number>`	Skip results
`-s, --search <string>`	Full-text search
`-t, --type <string>`	Filter by type: `tweet`, `link`, `youtube`
`-p, --pretty`	Human-readable output

scx bookmarks list --search "react" --type link --limit 10 --pretty

`scx bookmarks add <url>`

Save a new bookmark. The URL is automatically scraped for title, content, and metadata.

scx bookmarks add "https://example.com/article" --pretty

YouTube URLs are automatically detected — the video title, transcript, and thumbnail are extracted.

`scx bookmarks get <id>`

Get a bookmark by ID.

scx bookmarks get abc123 --pretty

`scx bookmarks delete <id>`

Delete a bookmark.

scx bookmarks delete abc123

Groups

`scx groups list`

List all groups.

scx groups list
scx groups list --json    # Raw JSON output

`scx groups create <name>`

Create a new group.

scx groups create "AI Research"

`scx groups delete <id>`

Delete a group.

scx groups delete abc123

Sync

`scx sync twitter`

Sync bookmarks from X (Twitter). Handles rate limits automatically — pauses and resumes where it left off.

scx sync twitter
scx sync twitter --since 2024    # Only sync from 2024 onwards

`scx sync status`

Check the latest sync status.

scx sync status

Returns the sync status (completed, interrupted, in-progress, or none), number of tweets synced, and rate limit info.

Conversations

Store summaries of your AI conversations as persistent memory.

`scx conversation list`

scx conversation list [options]

Option	Description
`-s, --search <string>`	Search conversations
`--tier <tier>`	Filter by tier: `brief`, `summary`, `detailed`
`-l, --limit <number>`	Max results (default: 20)
`-o, --offset <number>`	Skip results
`-p, --pretty`	Human-readable output

`scx conversation add <content>`

Save a conversation summary. The --tier flag is required.

scx conversation add "Decided to use Fumadocs for docs" --tier brief
scx conversation add "Discussed React hooks and optimization" --tier summary --title "React discussion"

Option	Description
`--tier <tier>`	Required. `brief` (1 sentence), `summary` (bullet points), `detailed` (full doc)
`-t, --title <string>`	Title for the conversation
`-m, --metadata <json>`	Metadata as JSON
`-p, --pretty`	Human-readable output

`scx conversation get <id>`

scx conversation get abc123 --pretty

`scx conversation update <id>`

Update a saved conversation. At least one field must be provided.

scx conversation update abc123 --content "Updated summary" --tier detailed

`scx conversation delete <id>`

scx conversation delete abc123

Utility

`scx update`

Check for updates and install the latest version.

scx update

Output formats

Most commands default to JSON output. Add --pretty (or -p) for human-readable output. Groups commands use --json (or -j) for raw JSON.

CLI Reference

On this page