| name | log-viewer |
| description | Stream and tail Docker container logs using container-log-viewer. Covers clv tail, clv list, and the real-time web UI feed. |
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.
