Local CLI

Run Algora projects locally with one command

The first CLI release standardizes local startup around .algora/dev.json. Algora-created repos can carry this file by default, and onboarded repos can add it with a preset and then tune it.

Install

Today the CLI is installed from this repo directly. Publishing can come later once the auth and project-sync layer is ready.

npm link ./packages/cli

Use It

algora login

List your projects

algora projects

Run an Algora-managed repo

algora dev

Disable the paywall in local development

algora dev --no-paywall

Create a manifest for an onboarded repo

algora init --preset nextjs-hono

Credential Storage

CLI login uses a browser approval flow and stores the revocable token in the OS credential store when possible.

macOS: Keychain via security
Linux: libsecret via secret-tool
Fallback: local auth file with a warning when no OS secret store is available

Current Presets

nextjs-hono
nextjs
vite-react
hono
express

What This Release Covers

Local process startup from a shared manifest contract.
Automatic local Stripe webhook forwarding when the Stripe CLI is installed and logged in.
Paywall enforcement in dev by default, with --no-paywall for bypassing it locally.
A manual path for onboarded repos via algora init.

What Comes Next

CLI login, project discovery, local Supabase orchestration, and Railway dev-environment support are the next product layers. The right long-term move is for the CLI to know about your Algora account and projects directly, but this first slice keeps the local-dev contract simple and real.

Need the setup flow first? Start in Connections or open a project from Dashboard.