Purly CLI

Command-line interface for the Purly API. Manage your library, feeds, labels, and timeline from the terminal.

Install

Run directly with npx (no install needed):

npx @purly-app/cli library list

Or install globally:

npm i -g @purly-app/cli
purly library list

Standalone binary

For a single binary with no Node/npm dependency:

cd cli
bun run build
ln -sf "$(pwd)/dist/purly-darwin-arm64" /usr/local/bin/purly

Use purly-darwin-x64 on Intel Macs, or purly-linux-x64 on Linux.

Setup

Create an API token at purly.app/settings, then:

purly login

If you're running the dev server locally:

purly login --api-url http://localhost:3000

Usage

purly library list                        # list recent purls
purly library list --limit 10             # fewer results
purly library list --sort alphabetical    # different sort
purly library list --label <id>           # filter by label
purly library list --search "keyword"     # search by name
purly library add https://example.com     # add a URL
purly library get <id>                    # get purl details
purly library remove <id>                 # remove a purl
purly library label <id> <label-id>       # add label to purl
purly library unlabel <id> <label-id>     # remove label from purl

purly labels list                         # list all labels
purly labels create my-label              # create a label
purly labels delete <id>                  # delete a label

purly feeds list                          # list your feeds
purly feeds subscriptions                 # list subscriptions
purly feeds items <name>                  # list feed items
purly feeds publish <name> --url <url> --name "Title"

purly timeline                            # view your timeline

purly whoami                              # check auth status
purly logout                              # remove stored token

Every list command supports --json for raw JSON output and --limit/--cursor for pagination:

purly library list --json | jq '.data[0].name'
purly timeline --limit 50

Development

Run without compiling:

bun run src/index.ts -- library list