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, curl, or Docker

CLI Reference

Complete flag and option 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 log files with timestamps and container names perfect for AI analysis.

Docker Compose Support

Works seamlessly with Docker Compose projects and services.

Flexible Filtering

Filter logs by regex patterns, exclude noisy containers, and mute specific streams.

Multiple Output Formats

JSON output, combined logs, per-container logs, or raw stream mode.

​
Quick Install

go install github.com/Mscotello/docker-agent-tail@latest
Make sure $HOME/go/bin is in your PATH. Add this to your shell profile (e.g., ~/.zshrc or ~/.bashrc):
export PATH="$PATH:$HOME/go/bin"

​
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 'DEBUG'

# Output combined logs to a file
docker-agent-tail --all --output logs/combined.log

​
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