log-viewer

# log-viewer skill

Use this skill when the user wants to:
- Stream live logs from a Docker container
- View recent logs with level filtering
- List all containers being tracked
- Open the web UI to view logs in a browser

## Prerequisites

The clv server must be running:

```
node dist/clv-server.js
# or via the compiled binary
clv-server
```

The server attaches to Docker containers automatically on start and polls for new containers every 10 seconds.

## List tracked containers

```
clv list
```

Output columns: NAME, IMAGE, STATUS, LINES, ERRORS, LAST LOG

Stopped containers are shown with reduced styling. The ERRORS column counts lines parsed as ERROR level.

## Tail a container

```
clv tail <container-name>
```

Streams all new log lines as they arrive via SSE. Press Ctrl+C to stop.

Options:

```
--level <levels>       Comma-separated: info,warn,error,debug  (default: all)
--stream <stdout|stderr>  Filter by stream
--since <n>m|h         Show lines from last N minutes or hours before streaming
--no-color             Disable ANSI color output
--format <text|json>   Output format (default: text)
```

Examples:

```
# Errors and warnings only
clv tail api --level error,warn

# Last 30 minutes of logs then stream
clv tail web --since 30m

# JSON output for piping
clv tail worker --format json | jq '.msg'
```

## Tail multiple containers

Use shell concurrency:

```
clv tail web &
clv tail api &
clv tail worker
```

Or view all containers in the web UI dashboard (All containers feed).

## Web UI

Open http://127.0.0.1:3200 in a browser (or CLV_SERVER if set).

- Left sidebar: container list with line counts and status dots
- Main panel: log feed with TIME / LEVEL / STREAM / MESSAGE columns
- Level chips at the top right filter the feed instantly
- Click any log row to expand and see the full JSON payload
- LIVE badge shows SSE is connected; new lines appear without refresh

## Environment variable

```
CLV_SERVER=http://myhost:3200  # default: http://localhost:3200
```

Used by the CLI to locate the server. Set this if the server is on a remote host or non-default port.

## Log level colors (terminal)

| Level | Color     |
|-------|-----------|
| ERROR | red       |
| WARN  | amber     |
| INFO  | blue      |
| DEBUG | dim grey  |
| -     | dim grey  |

ERROR lines get a dark red background and left border in the web UI.

## Retention

Logs older than the configured retention period (default 7 days) are pruned on startup and once per day. Adjust with the CLV_RETENTION_DAYS env var or via Settings in the web UI.