pelagora-cli-installer

CLI tool that scaffolds a self-hosted Pelagora node.

Quick Start (npm)

npx pelagora-cli-installer

This downloads the latest version from npm and runs the interactive setup.

Non-interactive mode

Pass CLI flags to skip the interactive prompts (useful for scripts, CI, and piped environments):

npx pelagora-cli-installer --name pelagora-beacon --port 8080 --pm npm

| Flag | Description | Default | |------|-------------|---------| | --name <dir> | Beacon name | beacon-pelagora | | --path <dir> | Install location | current directory | | --port <n> | HTTP port | 3000 | | --pm <npm\|yarn\|pnpm> | Package manager | npm | | --ai-tool <claude\|cursor\|windsurf\|none> | AI tool (installs skill file) | none | | --api-key <key> | Reffo.ai API key | (none) | | --api-url <url> | Reffo.ai API URL | https://reffo.ai | | -y / --yes | Accept all defaults | — |

Running from Source

If you've cloned this repo to contribute or develop locally:

git clone https://github.com/ReffoAI/pelagora-cli-installer.git
cd pelagora-cli-installer
node src/index.js

The installer detects when it's run from inside its own repo and automatically creates the project in the parent directory.

What It Does

The installer prompts you for:

• Project directory — where to create your node (default: pelagora-beacon)
• HTTP port — port for the beacon server (default: 3000)
• Package manager — npm, yarn, or pnpm
• Reffo.ai API key — optional, for syncing items to reffo.ai

Then it scaffolds a project with:

• package.json with pelagora as a dependency
• .env with your configuration
• .gitignore
• uploads/ directory

License

AGPL-3.0-only