gaze-so CLI

Zero-config observability CLI - pipe logs and visualize instantly.

Quick Start

# Production (default)
echo '{"cpu": 45, "memory": 78}' | gaze

# Local development
echo '{"test": 123}' | gaze --local

# Custom ports
echo '{"data": 123}' | gaze --web http://localhost:3000 --socket http://localhost:8080

Installation

npm install -g gaze-so

Usage

Pipe any output to gaze:

# JSON logs
echo '{"cpu": 45, "memory": 78}' | gaze

# Script output
python script.py | gaze
node server.js | gaze
docker logs -f | gaze

# Reuse session
echo '{"more": "data"}' | gaze --session-id gaze-abc123

Options

| Flag | Description | Example | |------|-------------|---------| | -s, --session-id <id> | Reuse existing session | gaze --session-id gaze-abc123 | | -l, --local | Use localhost (web: 3000, socket: 3001) | gaze --local | | --web <url> | Web server URL | gaze --web http://localhost:3000 | | --socket <url> | Socket server URL | gaze --socket http://localhost:8080 | | --server <url> | Shorthand for --web (auto-derives socket) | gaze --server http://localhost:3000 |

Server Configuration

The CLI automatically derives the socket URL from the web URL, but you can override it:

# Auto-derive socket (localhost:3000 → localhost:3001)
gaze --web http://localhost:3000

# Explicit socket URL
gaze --web http://localhost:3000 --socket http://localhost:8080

# Production (auto-derives socket.gaze.so)
gaze --server https://gaze.so

# Custom domain
gaze --web https://staging.gaze.so --socket https://socket-staging.gaze.so

Priority Order

1. Flags (--web, --socket, --local, --server)
2. Environment variables (GAZE_WEB_URL, GAZE_SOCKET_URL)
3. Production defaults (https://gaze.so, https://socket.gaze.so)

Environment Variables

export GAZE_WEB_URL=http://localhost:3000
export GAZE_SOCKET_URL=http://localhost:8080

Examples

# Production (default)
echo '{"data": 123}' | gaze

# Quick localhost
echo '{"data": 123}' | gaze --local

# Custom web server, auto socket
echo '{"data": 123}' | gaze --server http://localhost:3000

# Both custom
echo '{"data": 123}' | gaze --web http://localhost:3000 --socket http://localhost:8080

# Staging
echo '{"data": 123}' | gaze --server https://staging.gaze.so

License

MIT