CLI
Getting Started
Installation and configuration of the Saedra CLI
Installation
For end users (production)
npm install -g @usesaedra/cliAfter installing, the saedra command will be available globally.
Other package managers work too, same package:
pnpm add -g @usesaedra/cli
bun add -g @usesaedra/cliNo install, one-off run:
npx @usesaedra/cli status
bunx @usesaedra/cli statusFor developers (local)
# 1. Install dependencies from the monorepo root
pnpm install
# 2. Build the CLI
pnpm --filter @usesaedra/cli build
# 3. Link it globally so you can use "saedra" in your terminal
cd packages/cli && pnpm link --globalTo unlink later:
pnpm unlink --global @usesaedra/cliTo run without linking globally:
node packages/cli/dist/index.js <command>Configuration
| Variable | Description | Default |
|---|---|---|
SAEDRA_API_URL | API server URL | https://saedra-api.onrender.com |
SAEDRA_API_URL must be https://, or http:// pointing at localhost/127.0.0.1/::1. Any other http:// host is rejected — this stops your session token and code diffs from being sent unencrypted to a wrong or tampered-with URL.
In development, point the CLI to your local API:
export SAEDRA_API_URL=http://localhost:3002Or inline per command:
SAEDRA_API_URL=http://localhost:3002 saedra login