tilt-logs

Enhanced log viewing for Tilt with time-based filtering that the native tilt logs command lacks.

Why?

Tilt's built-in tilt logs command captures stdout/stderr from local_resource processes but lacks --since, --tail, or any time-based filtering. This makes it difficult for terminal agents to query logs effectively without overwhelming their context windows.

Installation

Via bunx (recommended)

bunx tilt-logs --help

Global install

bun install -g tilt-logs

Standalone binary

bun run build:standalone
./dist/tilt-logs --help

Usage

# View logs from specific resource
tilt-logs <resource>

# Filter by time (5m, 1h, 30s, 1d)
tilt-logs <resource> --since 5m

# Last N lines
tilt-logs --tail 100

# Stream logs (follow mode)
tilt-logs -f
tilt-logs <resource> -f

# JSON output for parsing
tilt-logs --json | jq .

# Custom Tilt instance
tilt-logs --host 192.168.1.100 --port 10351

Options

| Flag | Short | Description | |------|-------|-------------| | --since <dur> | -s | Show logs since duration (5m, 1h, 30s) | | --tail <num> | -n | Show last N log lines | | --follow | -f | Stream new logs | | --json | | Output as JSON lines | | --no-color | | Disable colored output | | --host <host> | | Tilt host (default: localhost) | | --port <port> | | Tilt port (default: 10350) | | --help | -h | Show help |

Environment Variables

• TILT_HOST - Tilt API host (default: localhost)
• TILT_PORT - Tilt API port (default: 10350)

Claude Code Plugin

Install the skill for Claude Code agents:

claude mcp add-plugin tilt-logs --path /path/to/tilt-logs

Or add to your Claude Code settings manually.

License

MIT