@getlogflow/cli

The official LogFlow CLI — tail and search your logs directly from the terminal.

Installation

npm install -g @getlogflow/cli
# or
npx @getlogflow/cli --help

Quick start

# 1. Save your API key (get it from app.getlogflow.com → Settings)
logflow auth lf_your_api_key

# 2. List your projects
logflow projects

# 3. Tail logs in real time
logflow tail

# 4. Query recent logs
logflow logs --limit 100

Commands

logflow auth <api-key>

Save your API key to ~/.logflow/config.json.

logflow auth lf_your_api_key

logflow projects

List all projects in your organization.

logflow projects

logflow tail [options]

Stream logs in real time via SSE. Press Ctrl+C to stop.

logflow tail                          # all logs, first project
logflow tail --project <id>           # specific project
logflow tail --service api            # filter by service
logflow tail --level error            # errors and above
logflow tail --filter "payment"       # message text search
logflow tail -s api -l warn           # combine filters

| Option | Description | |--------|-------------| | -p, --project <id> | Project ID (uses first project if omitted) | | -s, --service <name> | Filter by service name | | -l, --level <level> | Minimum level: debug\|info\|warn\|error\|fatal | | -f, --filter <text> | Filter by message text |

logflow logs [options]

Fetch recent logs (newest first).

logflow logs                          # last 50 logs
logflow logs --limit 200              # last 200 logs
logflow logs --level error            # errors only
logflow logs --service worker         # specific service
logflow logs --since 1h               # last hour
logflow logs --since 30m              # last 30 minutes
logflow logs --since 2d               # last 2 days

| Option | Description | |--------|-------------| | -p, --project <id> | Project ID (uses first project if omitted) | | -s, --service <name> | Filter by service name | | -l, --level <level> | Level: debug\|info\|warn\|error\|fatal | | -f, --filter <text> | Filter by message text | | -n, --limit <n> | Number of logs (default: 50, max: 500) | | --since <time> | Time window: 30m, 1h, 2d |

Config

Config is stored at ~/.logflow/config.json:

{
  "apiKey": "lf_your_api_key",
  "apiUrl": "https://api.getlogflow.com"
}

Use --url with auth to point to a self-hosted instance:

logflow auth lf_key --url https://api.yourcompany.com

License

MIT