agentsview

一个本地优先（local-first）的桌面及 Web 应用程序，用于浏览、搜索和分析 AI Agent 的编码会话。支持 Claude Code、Codex、OpenCode 以及其他 9 种 Agent。

桌面应用

请从 GitHub Releases 下载适用于 macOS 或 Windows 的桌面安装程序。桌面应用包含自动更新功能，并作为本地 sidecar 运行服务器 —— 无需终端操作。

CLI 安装

curl -fsSL https://agentsview.io/install.sh | bash

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://agentsview.io/install.ps1 | iex"

CLI 安装程序会下载最新版本，验证 SHA-256 校验和，并安装二进制文件。

从源码构建 (需要 Go 1.25+ 且带有 CGO，以及 Node.js 22+):

git clone https://github.com/wesm/agentsview.git
cd agentsview
make build
make install  # 安装到 ~/.local/bin

为什么选择 agentsview？

AI 编码 Agent 在项目中会产生海量的会话数据。agentsview 将这些会话索引到本地的 SQLite 数据库中，并提供全文本搜索功能，通过 Web 界面帮助你查找过往对话、回顾 Agent 行为并追踪长期的使用模式。

功能特性

• 全文本搜索：跨所有消息内容进行即时搜索
• 分析仪表盘：提供活动热图、工具使用情况、执行速度指标及项目明细
• 多 Agent 支持：支持 Claude Code、Codex、OpenCode 及其他 9 种 Agent（查看完整列表）
• 实时更新：通过 SSE（Server-Sent Events）在活动会话收到新消息时即时更新
• 键盘优先：支持键盘导航（Vim 风格的 j/k/[/]）
• 导出与发布：将会话导出为 HTML 或发布到 GitHub Gist
• 本地优先：所有数据均存储在你的机器上，单一二进制文件，无需注册账号

使用方法

agentsview              # 启动服务器
agentsview -port 9090   # 指定自定义端口

启动时，agentsview 会自动发现所有受支持 Agent 的会话，将其同步到带有 FTS5 全文搜索功能的本地 SQLite 数据库中，并在 http://127.0.0.1:8080 打开 Web UI。

如果需要通过主机名或反向代理访问，请设置 public_url。这既保留了默认的 DNS 重绑定（DNS-rebinding）和 CSRF 防护，又能明确信任你期望的外部浏览器来源。

# 在自定义主机名/端口上通过 HTTP 直接访问
agentsview -host 0.0.0.0 -port 8004 \
  -public-url http://viewer.example.test:8004

# 在你自己的反向代理后使用 HTTPS
agentsview -host 127.0.0.1 -port 8004 \
  -public-url https://viewer.example.test

agentsview 还可以为你管理 Caddy 前端。在 Caddy 管理模式下，保持后端在本地回环（loopback）接口，由 Caddy 处理 TLS 终止，并根据需要限制客户端 IP 范围。默认情况下，托管的 Caddy 绑定到 127.0.0.1 并通过 8443 端口暴露公共 URL。若要在非回环接口上暴露，请明确设置 -proxy-bind-host 并至少提供一个 -allowed-subnet。

Caddy 管理模式要求系统已安装 caddy CLI。此程序不会自动安装 Caddy，请使用你常用的操作系统包管理器，或要求你的编码 Agent 为你的平台安装 Caddy。Caddy 支持 Linux、macOS 和 Windows。

对于如 443 或 80 等特权端口，建议保持 agentsview 本身非特权运行，并赋予 Caddy 二进制文件绑定低位端口的权限。在 Linux 上，通常执行：

sudo setcap cap_net_bind_service=+ep "$(command -v caddy)"

然后以普通用户身份运行 agentsview 并使用 -public-port 443 或 -public-port 80。这避免了以 root 身份运行会话查看器，否则会改变其访问的主目录及 Agent 会话数据的位置。如果你不需要特权端口，默认的 8443 是更简单的选择。

agentsview -host 127.0.0.1 -port 8080 \
  -public-url https://viewer.example.test \
  -proxy caddy \
  -proxy-bind-host 0.0.0.0 \
  -public-port 8443 \
  -tls-cert ~/.certs/viewer.crt \
  -tls-key ~/.certs/viewer.key \
  -allowed-subnet 10.0/16 \
  -allowed-subnet 192.168.1.0/24

你可以将相同的设置持久化在 ~/.agentsview/config.toml 中：

public_url = "https://viewer.example.test"

[proxy]
mode = "caddy"
bind_host = "0.0.0.0"
public_port = 8443
tls_cert = "/home/user/.certs/viewer.crt"
tls_key = "/home/user/.certs/viewer.key"
allowed_subnets = ["10.0/16", "192.168.1.0/24"]

当你需要允许除主 public_url 之外的其他浏览器来源时，public_origins 仍然作为高级选项可用。

截图

仪表盘	会话查看器

搜索	活动热图

键盘快捷键

按键	操作
Cmd+K	打开搜索
j / k	下一条 / 上一条消息
] / [	下一个 / 上一个会话