@retrograde-labs/lune-cli

Lune CLI — agent-native research data + tools.

Install

# npm (cross-platform)
npm install -g @retrograde-labs/lune-cli

# Homebrew (macOS / Linux)
brew tap luneresearch/lune
brew install lune

# curl (macOS / Linux, no Node required)
curl -fsSL https://luneresearch.com/install.sh | sh

Quickstart

lune login                     # OAuth in your browser
lune whoami                    # confirm signed in

lune papers search "linformer attention" --limit 5
lune conferences list --category ml
lune guidance search "how to write a related work section"

lune install                   # configure Claude Code / Desktop with MCP

Commands

| Command | Description | |---------|-------------| | lune login | OAuth sign-in (or --api-key <pat>) | | lune logout | Clear local credentials | | lune whoami | Show org, tier, usage | | lune orgs list / use <slug> / current | Manage active org | | lune keys list / create --name X / revoke <id> | PAT management | | lune papers search / get / fulltext / citations | Paper search + read | | lune conferences list / papers <name> | Browse conferences | | lune guidance search / get | Curated research best-practices | | lune subs list / create / delete / drain | Conference subscriptions | | lune install | Wire MCP into Claude Code / Desktop | | lune doctor | Diagnostics (config, runtimes, API health) | | lune update | Self-update via npm |

Global flags

• --json — machine-readable JSON instead of tables
• --profile <name> — switch between configs in ~/.lune/config.json

Configuration

Profiles live in ~/.lune/config.json. Each profile holds either a PAT or OAuth token bundle plus the active org slug. Switch profiles with --profile <name> on any command.

Development

pnpm install
pnpm --filter @retrograde-labs/lune-cli build
pnpm --filter @retrograde-labs/lune-cli test
pnpm --filter @retrograde-labs/lune-cli typecheck

# Run from source without building
pnpm --filter @retrograde-labs/lune-cli dev -- --help

License

MIT