@logfox/cli

CLI tool for sending local development logs to Logfox.

npm setup: Uses private @logfoxai packages. See home for the one-time npm + gh auth setup.

Installation

npm install -g @logfox/cli

Quick Start

# Authenticate
logfox login

# Run your app with logging
logfox run --name my-app -- npm start

Logs appear in Logfox under environment "local".

Commands

Run logfox --help to see all available commands.

How it Works

1. logfox run wraps your command and captures stdout/stderr
2. Logs are parsed (JSON or plain text) and batched
3. Sent to Logfox under environment "local" with app name local-{hash}-{name}
4. Issues are detected and grouped just like production logs

Log Parsing

• JSON logs (pino, winston, bunyan): Structure is extracted automatically
• Plain text: Log levels detected from common patterns (ERROR, WARN, INFO, DEBUG)

Configuration

Config is stored in ~/.logfox/config.json. Use logfox config to view current settings.

| Key | Default | Description | |-----|---------|-------------| | apiUrl | https://api.logfox.ai | Logfox API endpoint | | appUrl | https://app.logfox.ai | Logfox web app (for login) | | teamId | (from login) | Active team |

Local Development

To point the CLI at local services:

logfox config:set apiUrl http://localhost:3000
logfox config:set appUrl http://localhost:4000
logfox login

Commits & releases

AutoRel. Conventional commits — see the commit format.