Skip to main content
docker-agent-tail docker-agent-tail

​
Docker logs for AI agents

Auto-discover Docker containers, tail their logs in real-time, and write structured files optimized for AI coding agents like Claude Code and Cursor.

Get Started

5-minute tutorial to get up and running

Installation

Install via Homebrew, Go, or curl

CLI Reference

Complete command and flag reference

AI Agents

Integrate with Claude Code, Cursor, and Windsurf

​
Key Features

Auto-Discovery

Automatically detects all running Docker containers without manual configuration.

Real-Time Streaming

Tail logs as they happen with configurable filtering and output formatting.

AI-Optimized Output

Structured JSONL log files with normalized levels and metadata, perfect for AI analysis.

Docker Compose Support

Works seamlessly with Docker Compose projects and services.

Flexible Filtering

Filter logs by regex patterns, exclude noisy lines, and mute specific containers from terminal output.

lnav Integration

View structured JSONL logs with lnav — SQL queries, regex filtering, and color-coded levels.

​
Quick Install

brew install Mscotello/tap/docker-agent-tail

​
Basic Usage

# Tail all container logs in real-time
docker-agent-tail --all --follow

# Tail specific containers
docker-agent-tail --names api,web --follow

# Filter logs with regex
docker-agent-tail --all --exclude 'health' --mute 'worker'

# View saved logs with lnav
lnav logs/latest/combined.jsonl

​
Ready to get started?

Read the full getting started guide to learn how to use docker-agent-tail with AI agents.

Getting Started Guide

Follow the 5-minute tutorial