@logfox/cli

CLI tool for sending local development logs to Logfox.

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