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

Basic Usage

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