The Lune command line app

The Lune command line app gives you a quick, scriptable way to talk to your Lune account from a terminal. Search papers, manage subscriptions, top up credits, switch teams — without opening the dashboard or the browser.

It's optional. If you only ever talk to Lune through your AI app, you don't need it.

Install it

npm install -g @retrograde-labs/lune-cli

If you don't have Node, install it first via nodejs.org or your package manager.

Sign in

lune login

This opens a browser tab where you sign in with your Lune account. The command line app remembers you so you don't have to do it again.

lune whoami

Shows which account you're signed in as, your current plan, your remaining requests for today, and your credit balance.

Connect Lune to a desktop AI app

The command line app can wire up most desktop AI apps for you in one step.

lune install --client claude-desktop
lune install --client cursor
lune install --client vscode
lune install --client codex
lune install --client claude-code

You can run more than one. The command updates the right configuration file for each app and creates an API key behind the scenes.

To remove a connection later:

lune uninstall --client cursor       # remove a single app
lune uninstall --all                 # remove every connection

Search & explore

These commands hit the same Lune that your AI assistant does, so you can use them as a sanity-check or in shell scripts.

lune papers search "differential privacy"
lune papers get <paper-id>
lune papers fulltext <paper-id>
lune papers citations <paper-id>
 
lune conferences list --category ml
lune conferences papers neurips --year 2024
 
lune subs list
lune subs create neurips
lune subs delete <id>
lune subs drain <id>            # pull new papers since last check
 
lune guidance search "ablation study"
lune guidance get <id>

Add --json to any command for machine-readable output. Account, team, and billing commands are always free; everything else costs one request against your daily allowance, just like an AI app would.

Manage your account

lune teams list                  # all teams you belong to
lune teams use <slug>            # set the active team for this profile
lune teams current               # show the active team
 
lune keys list                   # API keys for the active team
lune keys create --name laptop   # create a new key (shown once)
lune keys revoke <id>

The active team is what papers search and other commands run against. Switch teams freely; nothing is shared across teams unless you choose.

Multiple identities

If you use Lune for both personal and team work, the --profile flag keeps them separate.

lune --profile work login
lune --profile work teams use acme
lune --profile work papers search "alignment"

default is used when you don't pass --profile. Each profile has its own sign-in and its own active team.

Diagnostics

lune doctor

Reports anything obviously off — wrong account, expired key, a configuration file the install command can't reach. If something feels wrong, run this first.