@superlog/cli

Instrument your project and start shipping observability in under a minute.

npx @superlog/cli

What it does

superlog init detects your stack, writes the OTel instrumentation, and points your spans at Superlog — your project starts receiving traces, logs, and metrics immediately.

From there, Superlog surfaces error patterns as issues, lets your AI tools query telemetry over MCP, and can propose fixes via a managed agent that opens PRs against your repo.

Usage

# One-shot setup (no install needed)
npx @superlog/cli

# Or install globally
npm i -g @superlog/cli
superlog init

Options

superlog init [--cwd <path>]

  --cwd   Project directory to instrument (default: current directory)

Agent management (macOS)

Superlog can run a local on-host agent via launchd:

superlog agent install \
  --endpoint https://intake.superlog.sh \
  --token <ingest-token> \
  --project-id <project-id> \
  --service-name <my-service>

superlog agent status
superlog agent uninstall

Requirements

• Node.js ≥ 20
• A Superlog account (the CLI walks you through sign-up)

Publishing a new version

Tag a release — CI handles the rest:

npm version patch   # or minor / major
git push origin main --tags

License

MIT