Logpilot

Welcome to LogPilot 🚀

[](https://github.com/jellydn/logpilot/releases) [](LICENSE) [](https://rust-lang.org) [](https://github.com/jellydn/logpilot/actions)

> AI-Native tmux Log Copilot for Support Incident Tracking

LogPilot captures live tmux pane output, performs real-time log analysis (anomaly detection, deduplication, clustering), and exposes structured incident context via MCP (Model Context Protocol) to Claude Code/Codex for AI-assisted incident response.

🏠 Homepage

✨ Demo

Pre-requirements

• Rust — A language empowering everyone to build reliable and efficient software
• tmux — A terminal multiplexer

💻 Stack

• tokio: A runtime for writing reliable asynchronous applications with Rust.
• clap: A full featured, fast Command Line Argument Parser for Rust
• serde: A generic serialization/deserialization framework
• crossterm: A crossplatform terminal manipulation library
• dashmap: A fast concurrent hashmap
• sqlx: The Rust SQL Toolkit
• uuid: A library to generate and parse UUIDs
• chrono: Date and time library for Rust
• tracing: A scoped, structured logging and diagnostics system
• regex: An implementation of regular expressions for Rust

📝 Project Summary

• [src/analyzer](src/analyzer): Anomaly detection and pattern analysis.
• [src/buffer](src/buffer): Log storage with ring buffer and SQLite persistence.
• [src/capture](src/capture): tmux integration for streaming log capture.
• [src/cli](src/cli): CLI commands (watch, summarize, ask, status, mcp-server).
• [src/mcp](src/mcp): MCP protocol implementation for AI context bridge.
• [src/models](src/models): Data structures (LogEntry, Session, Pattern, Alert, etc.).
• [src/pipeline](src/pipeline): Log processing (parse, dedup, cluster).
• [src/observability.rs](src/observability.rs): Structured logging and metrics.
• [tests/](tests/): Integration and unit tests.
• [completions/](completions/): Shell completions for bash, zsh, fish.

Install

cargo install logpilot

Or install directly from GitHub:

cargo install --git https://github.com/jellydn/logpilot --locked

Or build from source:

git clone https://github.com/jellydn/logpilot
cd logpilot
cargo build --release

Usage

1. Watch a tmux session

# Watch an existing tmux session
logpilot watch my-session

# Watch with custom buffer duration
logpilot watch my-session --buffer 10

# Watch specific pane
logpilot watch my-session --pane my-session:1.0

2. Get a summary

# Summary of last 10 minutes
logpilot summarize --last 10m

# JSON output for scripting
logpilot summarize --last 5m --format json

3. Ask AI-assisted questions

# Format query for Claude/Codex
logpilot ask "Why are checkout requests failing?"

# Include raw logs in context
logpilot ask "What changed in the last hour?" --include-logs

4. Check status

logpilot status

Configuration

Create ~/.config/logpilot/config.toml (see [config.example.toml](config.example.toml)):

[buffer]
duration_minutes = 30
max_memory_mb = 100
persist_severity = ["ERROR", "FATAL"]

[alerts]
recurring_error_threshold = 5
error_rate_threshold_per_minute = 10

[mcp]
enabled = true
transport = "stdio"

MCP Server Mode

LogPilot exposes an MCP server for Claude Code integration:

logpilot mcp-server --verbose

Add to your Claude Code configuration (~/.claude/config.json):

{
  "mcp_servers": [
    {
      "name": "logpilot",
      "command": "logpilot",
      "args": ["mcp-server"],
      "env": {}
    }
  ]
}

Run tests

cargo test

Run with logging

RUST_LOG=info cargo run -- watch my-session

Shell Completions

# Bash
source completions/logpilot.bash

# Zsh
source completions/logpilot.zsh

# Fish
source completions/logpilot.fish

Pre-commit

This project uses pre-commit to enforce code quality. To install hooks:

pre-commit install

📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

Author

• Website: https://productsway.com/
• Twitter: @jellydn
• Github: @jellydn

Star History 🌟

[](https://star-history.com/#jellydn/logpilot)

Show your support

Give a ⭐️ if this project helped you!

Contributors ✨

Thanks goes to these wonderful people:

This project follows the all-contributors specification. Contributions of any kind welcome!

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: jellydn
• Source: jellydn/logpilot
• License: MIT

Install and usage instructions live in the source repository linked above.