logdump (App Gram)

日志转储

用于AI代理的实时日志聚合工具，带有TUI和MCP服务器。

 

特性

• 实时日志跟踪 -同时查看多个日志文件
• 美丽的TUI -带有颜色编码流、搜索和导航的终端UI
• MCP服务器 -通过模型上下文协议将日志暴露给AI代理
• 自动发现 -自动查找 .log 和 .txt 日志目录中的文件
• 流过滤 -打开/关闭流，使用正则表达式搜索
• 反向模式 -在顶部或底部查看最新日志
• 代码已签名 -macOS二进制文件已使用开发人员ID签名

安装

自制（macOS/Linux）

brew tap appgram/tap
brew install logdump

直接下载（macOS、Linux、Windows）

从下载预构建的二进制文件 发布页面:

# macOS Apple Silicon
curl -L https://github.com/appgram/logdump/releases/download/v1.0.1/logdump_v1.0.1_darwin_arm64.tar.gz | tar xz
chmod +x logdump
mv logdump /usr/local/bin/

# macOS Intel
curl -L https://github.com/appgram/logdump/releases/download/v1.0.1/logdump_v1.0.1_darwin_amd64.tar.gz | tar xz
chmod +x logdump
mv logdump /usr/local/bin/

# Linux x86_64
curl -L https://github.com/appgram/logdump/releases/download/v1.0.1/logdump_v1.0.1_linux_amd64.tar.gz | tar xz
chmod +x logdump
sudo mv logdump /usr/local/bin/

# Linux ARM64
curl -L https://github.com/appgram/logdump/releases/download/v1.0.1/logdump_v1.0.1_linux_arm64.tar.gz | tar xz
chmod +x logdump
sudo mv logdump /usr/local/bin/

来源

git clone https://github.com/appgram/logdump.git
cd logdump
./install.sh

去安装

go install github.com/appgram/logdump@latest

用法

TUI模式

# Run with auto-discovery of log files
logdump

# Only show new logs (skip history)
logdump -tail

# Exclude specific streams
logdump -exclude mcp-activity,sample

# Use custom config
logdump -config /path/to/config.yaml

MCP服务器模式

# Start MCP server for AI agents
logdump -mcp

TUI键盘快捷键

配置

Logdump使用位于以下位置的YAML配置文件 ~/.config/logdump.yaml:

# Log directory for auto-discovery
log_dir: ~/.local/share/logdump/logs

# Manual stream definitions (optional)
streams:
  - name: myapp
    path: /var/log/myapp
    patterns:
      - "*.log"
    color: cyan

# Log groups for filtering
groups:
  - name: errors
    pattern: "ERROR|FATAL|ERR"
    color: red

流颜色

可用颜色： red, green, blue, yellow, cyan, magenta, white

MCP集成

Logdump通过以下方式向AI代理公开日志 模型上下文协议.

Claude代码设置

添加到您的Claude Code MCP设置中：

{
  "mcpServers": {
    "logdump": {
      "command": "logdump",
      "args": ["-mcp"]
    }
  }
}

可用的MCP工具

为代理编写日志

应用程序可以将日志写入共享目录以供代理访问：

# Default log directory
~/.local/share/logdump/logs/

# Example: write from your app
echo "[$(date)] INFO Starting service" >> ~/.local/share/logdump/logs/myapp.log

建筑

# Build
make build

# Build and sign (macOS)
make build-signed

# Install locally
make install

# Run tests
make test

需求

• 转到1.21+
• macOS、Linux或Windows

许可证

MIT许可证-请参阅 许可证

贡献

欢迎投稿！请打开问题或提交拉取请求。