Install and set up

Requirements

• Node.js 20 or newer
• git
• An AI backend: either the claude CLI on your PATH, or ANTHROPIC_API_KEY set

Install

npm install -g @postlyra/cli

Set up

postlyra init
postlyra login

init asks for the API URL, the folders to scan, an optional notes folder, the mining window in days, and how many ideas a run should ask for. Press enter to keep any current value.

login asks for your email and password, plus a two-factor code if you have 2FA on. It stores a token and picks a brand: automatically when the account has one, by asking when it has several.

Both write to ~/.config/postlyra/config.json, with mode 600 because it holds your API token.

Check it

postlyra status

API: https://api.postlyra.com
Logged in as [email protected]
Brand: My Brand (0f8fad5b-d9cb-469f-a165-70867728950e)
Folders: ~/Sites
Vault: ~/Sites/second-brain
Unmined items: 8 of 22 in the last 7 day(s)

This checks auth, brand, folders and the unmined count without mining anything or spending a token.

Your first run

Look before you leap:

postlyra mine --dry-run

That collects and filters, prints the work log the AI would see, and stops. No AI call, no push.

When it looks right:

postlyra mine

Brands

One login token serves every brand on your account. login pins this machine to one.

postlyra brands              # list them, * marks the selected one
postlyra brands use <id>     # switch
postlyra mine --brand <id>   # override for one run

An account with several brands and none selected refuses to mine rather than guessing.

What folders should I point it at

folders entries are either a git repo itself, or a parent folder holding several repos one level down.

{ "folders": ["~/Sites"], "exclude": ["*/website"] }

Pointing at ~/Sites picks up every repo directly inside it. Each is labelled Sites/myproject, and that label is the only thing about the repo that ever reaches Postlyra.

exclude patterns match against that label. * matches within one path segment, so */website excludes every project's website repo without touching anything else.

Prerequisite

The brand needs a content profile before mining works, because that is where the voice and pillars come from. Without one you get:

No profile configured for this team yet — add one before importing ideas.

Create one in Studio. See Content profiles.

Upgrading

postlyra upgrade

Runs a global npm install of the latest published version. Run postlyra --version afterwards to confirm.