AgentsView 快速上手从安装、启动到自定义配置的完整实战指南【免费下载链接】agentsviewLocal-first session search, analytics, insights, and token use statistics for coding agents, supporting Claude Code, Codex, and more than 20 other agents.项目地址: https://gitcode.com/GitHub_Trending/ag/agentsview本文为 AgentsView一款面向 Claude Code、Codex 等 20 余种编码 Agent 的本地优先会话搜索、分析与 Token 用量统计工具的快速上手指南。读完你可以选择最适合的安装方式桌面应用、PyPI、Shell 脚本、源码编译或 Docker部署 AgentsView理解serve与daemon两种运行模式的生命周期并通过环境变量或配置文件把会话目录指向自定义路径包括 S3 兼容存储最终获得一个可搜索、可分析、可导出的 Agent 会话仪表盘。安装 AgentsViewAgentsView 提供 5 种安装途径按场景选择即可。桌面应用Desktop App在 macOS 上最便捷的安装方式是 Homebrew Caskbrew install --cask agentsview在 Windows 和 Linux 上也可作为 macOS 的替代方案从项目的 GitHub Releases 页面下载最新的.dmg、.exe或.AppImage安装包。桌面应用是完全自包含的打包产物——无需 CLI、无额外依赖并内置自动更新能力。桌面应用与 CLI 共享同一数据目录~/.agentsview/二者可以任意组合使用完全互补而非互斥。macOS 上的行为细节关闭桌面窗口只是隐藏窗口并不会退出 AgentsView。你需要通过菜单栏状态项来重新显示窗口、打开日志文件夹、检查更新或退出桌面应用及其托管的后端进程。pip / uvxpip install agentsview # 永久安装 uvx agentsview # 或不安装直接运行PyPI 上发布了平台专属 wheel覆盖Linuxx86_64、aarch64macOSx86_64、arm64Windowsx86_64、arm64Shell 安装脚本curl -fsSL https://agentsview.io/install.sh | bashWindowsPowerShellpowershell -ExecutionPolicy ByPass -c irm https://agentsview.io/install.ps1 | iex安装器的工作流程可以从 scripts/install.sh 源码中确认检测 OS 与架构detect_os支持Darwindarwin和Linuxlinuxdetect_arch将x86_64/amd64映射为amd64、aarch64/arm64映射为arm64解析最新版本号通过/releases/latest的 302 跳转获取标签版本而非走有速率限制的 GitHub API校验 SHA-256 校验和verify_checksum函数对照发布附带的SHA256SUMS文件校验二进制校验失败会直接终止安装可用AGENTSVIEW_SKIP_CHECKSUM1跳过但不推荐安装二进制优先写入/usr/local/bin若可写否则回退到~/.local/bin。Windows on ARM 说明安装器在 ARM 版 Windows 上优先使用原生arm64构建若该发布版本尚无 arm64 构建则回退到x86_64构建依靠 Windows 自带的 x64 模拟运行。想要原生二进制时可以自行从源码构建。从源码构建Build from Source前置要求以 go.mod 为准Go 1.27需开启 CGO和Node.js 24.11git clone https://gitcode.com/GitHub_Trending/ag/agentsview cd agentsview make build make install # 安装到 ~/.local/bin结合 Makefile 源码可以进一步理解这两条命令在做什么make build先执行pricing-snapshot从制品分支恢复内嵌的 LiteLLM 价格快照和frontendnpm ci npm run build并将产物拷贝到internal/web/dist供go:embed嵌入然后执行CGO_ENABLED1 go build -tags fts5 -ldflags$(LDFLAGS) -o agentsview ./cmd/agentsviewCGO是必需的因为 SQLite 驱动基于mattn/go-sqlite3的 C 绑定见go.mod依赖fts5构建标签启用全文搜索能力。Makefile 中还特意导出了CGO_CFLAGS指向 go-sqlite3 自带的 amalgamation 头文件目录避免使用系统 SDK 里可能与静态链接版本不一致的sqlite3.h该处注释说明头文件不匹配会导致编译告警甚至查询慢 2-3 倍。make install基于build-release优化且 strip并采用先写临时文件再原子 rename的方式落地到~/.local/bin——Makefile 注释解释原子替换会产生新 inode可避免 macOS 上旧进程仍在运行时覆盖二进制导致的 code-signature 校验 SIGKILL 问题。Windows on ARM 手动构建Windows 上没有make且 CGO 需要能编译aarch64目标的 C 编译器。请安装Windows/ARM64 版本的 GoNode.jsaarch64 的llvm-mingw工具链自包含的 clang 运行时无需 Visual Studio 或 Windows SDK。然后在 PowerShell 中手动构建git clone https://gitcode.com/GitHub_Trending/ag/agentsview cd agentsview # 1. 构建前端并嵌入 cd frontend; npm ci; npm run build; cd .. Copy-Item -Recurse -Force frontend/dist internal/web/dist # 2. 使用 aarch64 工具链编译 $env:CGO_ENABLED 1 $env:CC C:\path\to\llvm-mingw\bin\aarch64-w64-mingw32-clang.exe go build -tags fts5 -o agentsview.exe ./cmd/agentsview产物agentsview.exe是原生 ARM64 二进制。大多数用户不需要这样做——安装脚本和 PyPI wheel 都提供原生 arm64 构建——但这对开发调试或运行未发布的功能很有用。Docker每个 tag 发布和 main 分支推送都会向 GitHub Container Registry 发布linux/amd64与linux/arm64双架构镜像docker run --rm -p 127.0.0.1:8080:8080 \ -v agentsview-data:/data \ -v $HOME/.claude/projects:/assets/static/agents/claude:ro \ -e CLAUDE_PROJECTS_DIR/assets/static/agents/claude \ ghcr.io/kenn-io/agentsview:latest容器入口脚本 docker-entrypoint.sh 的逻辑很简单默认执行agentsview serve当设置PG_SERVE1或其等价真值时切换到agentsview pg serve——同一个镜像同时支持本地 SQLite 归档模式和 PostgreSQL 后端模式。关键部署要点容器内的 AgentsView 只能看到你显式 bind-mount 进去的 Agent 会话目录。请把每个 Agent 的会话根目录以只读方式挂载并把对应的目录环境变量指向容器内路径如上例中的CLAUDE_PROJECTS_DIR。/data卷在容器内归 root 所有建议优先使用命名卷named volume而非宿主机 bind mount若必须用宿主机目录请预先创建并设置好属主。仓库提供了生产风格的 Compose 示例 docker-compose.prod.yaml使用命名卷持久化/data只读挂载 Claude、Codex、OpenCode以及 Forge的会话根目录并将 UI 发布在127.0.0.1:8080docker compose -f docker-compose.prod.yaml up -d该示例仅将 UI 发布到回环地址。若要对外暴露请同时启用 bearer-token 认证并有意识地规划端口发布。PostgreSQL 后端部署时让容器指向共享数据库即可docker run --rm -p 127.0.0.1:8080:8080 \ -e PG_SERVE1 \ -e AGENTSVIEW_PG_URLpostgres://user:passwordhost:5432/agentsview?sslmoderequire \ ghcr.io/kenn-io/agentsview:latest运行桌面应用会自动处理启动流程附着到已存在的本地 daemon或后台启动一个然后打开发现的 URL。daemon 与 CLI 命令共享可能比桌面窗口存活更久当没有客户端请求或 daemon 拥有的任务活动时它会在空闲一段时间后自行退出。CLI 用户可以显式启动 Web UIagentsview serve裸agentsview serve在前台运行直到CtrlC。若已有兼容的服务器在运行它会报告该服务器的 URL 并直接退出。启动后它会依次在~/.agentsview/sessions.db初始化 SQLite 数据库发现并同步所有受支持的 Agent的会话开始监视会话目录的变化在http://127.0.0.1:8080启动 Web UI。在浏览器中打开http://127.0.0.1:8080。加--no-browser可禁用自动打开浏览器。也可以在后台启动同一服务器使其在 shell 退出后继续运行agentsview daemon start agentsview daemon status agentsview daemon restart agentsview daemon stopdaemon 包含 Web UI、API、会话同步和文件监视器——daemon start之后不需要再运行serve。daemon stop或serve stop会同时关闭 Web UI 和同步serve stop还会停止同一数据目录下的只读镜像服务器。几个从源码可验证的运行细节daemon start与daemon restart使用来自config.toml和支持的环境变量的正常生效配置不接受 serve 专属标志daemon restart在 daemon 已停止时也会将其启动并保持附着报告启动阶段直到替换 daemon 就绪CtrlC只是停止等待不会终止子进程之后可用agentsview daemon status检查。原有的agentsview serve --background、agentsview serve status、agentsview serve stop依然可用。当一次性 daemon 需要 serve 专属标志时例如--no-sync或未经认证的--host非回环覆盖使用serve --background。--no-sync是仅运行时标志无法写入config.toml参见 cmd/agentsview/cli.go 中no-sync标志的定义与NoSyncExplicit处理。并非每条 CLI 命令都需要常驻服务器只读命令在 daemon 热态时附着它否则直接以只读模式读取本地归档需要新数据或写操作的命令包括sync、usage、token-use、pg push、duckdb push会按需自动启动分离式 daemon且命令结束后服务器继续运行。对于必须不留下后台服务器的脚本或 CI 任务先停掉 daemon再运行AGENTSVIEW_NO_DAEMON1 agentsview sync该设置在 cmd/agentsview/cli.go 中被引用仅禁用自动启动不会停止已运行的 daemon也不会绕过其归档锁。自定义覆盖端口与主机agentsview serve --port 9090 agentsview serve --host 0.0.0.0 --port 3000 agentsview serve --no-browser # 禁用浏览器自动打开 agentsview serve --background --no-sync # 一次性、标志驱动的后台运行转发型开发环境提示如果你通过 exe.dev、Codespaces、Coder、WSL2、SSH 端口转发或反向代理访问 AgentsView请设置--public-url为浏览器实际访问的精确 origin 重启 CLI例如agentsview serve --public-url https://vm.exe.xyz仪表盘闪一下随后出现设置或 API 错误通常意味着服务器拒绝了转发的 host 或 origin——只要/api/v1/settings没有返回401就不是缺少认证 token 的问题。详见 Remote Access。从源码看--public-url会被校验必须包含 host并参与公开 origin 的解析参见 cmd/agentsview/managed_caddy.go 中rewriteConfiguredPublicURLPort等处理逻辑其解析路径在 cmd/agentsview/main_test.go 有覆盖测试。指向自定义会话目录各 Agent 的会话根目录可用环境变量覆盖。注意Aider 没有默认发现根必须设置AIDER_DIR才会扫描其日志export AIDER_DIR~/code export AMP_DIR~/custom/amp/threads # 仅历史本地 Amp 线程 export ANTIGRAVITY_DIR~/custom/antigravity export ANTIGRAVITY_CLI_DIR~/custom/antigravity-cli export CLAUDE_PROJECTS_DIR~/custom/claude/projects export COWORK_DIR~/custom/cowork export CODEX_SESSIONS_DIR~/custom/codex/sessions export COMMANDCODE_PROJECTS_DIR~/custom/commandcode/projects export COPILOT_DIR~/custom/copilot export CORTEX_DIR~/custom/cortex export CURSOR_PROJECTS_DIR~/custom/cursor/projects export DEEPSEEK_TUI_SESSIONS_DIR~/custom/deepseek/sessions export DEEPSEEK_HARNESS_SESSIONS_DIR~/custom/deepseek-harness/sessions export FORGE_DIR~/custom/forge export GEMINI_DIR~/custom/gemini export GOOSE_PATH_ROOT~/custom/goose export GPTME_DIR~/custom/gptme/logs export GROK_DIR~/custom/grok/sessions export HERMES_SESSIONS_DIR~/custom/hermes export IFLOW_DIR~/custom/iflow/projects export KILO_DIR~/custom/kilo export KILO_LEGACY_DIR~/custom/kilo-legacy export KIMI_DIR~/custom/kimi/sessions export KIMI_WORK_DIR~/custom/kimi-work/sessions export KIRO_SESSIONS_DIR~/custom/kiro export KIRO_IDE_DIR~/custom/kiro-ide export MIMOCODE_DIR~/custom/mimocode export VIBE_SESSIONS_DIR~/custom/vibe/logs/session export OMP_DIR~/custom/omp/sessions export OPENCLAW_DIR~/custom/openclaw/agents export OPENCODE_DIR~/custom/opencode export OPENCODEREVIEW_DIR~/custom/opencodereview/sessions export OPENHANDS_CONVERSATIONS_DIR~/custom/openhands export PI_DIR~/custom/pi/sessions export PIEBALD_DIR~/custom/piebald export POOLSIDE_DIR~/custom/poolside/trajectories export POSITRON_DIR~/custom/positron export QCLAW_DIR~/custom/qclaw/agents export QODER_PROJECTS_DIR~/custom/qoder/projects export QWEN_PROJECTS_DIR~/custom/qwen/projects export QWENPAW_DIR~/custom/qwenpaw export REASONIX_DIR~/custom/reasonix export ROOCODE_DIR~/custom/roocode export SHELLEY_DIR~/custom/shelley export TRAE_DIR~/custom/trae/User export VISUALSTUDIO_COPILOT_DIR~/custom/visualstudio-copilot/traces export VSCODE_COPILOT_DIR~/custom/vscode export WINDSURF_DIR~/custom/windsurf/User export WARP_DIR~/custom/warp export WORKBUDDY_PROJECTS_DIR~/custom/workbuddy/projects export ZCODE_DIR~/custom/zcode/cli export ZED_DIR~/custom/zed export ZENCODER_DIR~/custom/zencoder/sessions agentsview serve这些环境变量与config.toml中agents.id.dirs的关系规则详见 docs/configuration.md 的 Session Discovery 一节环境变量优先于配置键显式置空数组如agents.grok.dirs []会清除该 Agent 的默认本地目录省略该键则保持默认目录。S3 兼容会话源Claude / Codex / Cursor对 Claude、Codex 和 Cursor自定义根目录还接受s3://URI[agents.claude] dirs [s3://agent-archive/laptop/raw/claude] [agents.codex] dirs [s3://agent-archive/laptop/raw/codex] [agents.cursor] dirs [s3://agent-archive/laptop/raw/cursor]启动前需设置AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_REGION以及可选的AWS_S3_ENDPOINT用于指向 S3 兼容端点。预期的对象布局与同步行为参见 S3 兼容会话源 文档。你会看到什么服务运行起来后Web UI 提供会话列表支持按项目、Agent、日期、消息数过滤消息查看器完整内容、工具调用与 thinking 块会话智能健康等级、结果判定与信号面板全文搜索覆盖所有消息内容分析活动热力图、工具使用率、速度图表活动报告并发度、agent-minutes、成本与会话行明细会话导出导出为独立 HTML、用于 Agent 交接的 markdown 导出链接或 GitHub Gist。在全文搜索之外可选的语义搜索让agentsview session search --semantic或--hybrid按含义匹配会话内容由本地或托管的 embeddings 端点提供支撑具体配置见 Semantic Search 文档。至此无论选择哪种安装与运行方式AgentsView 的核心工作流发现 → 同步 → 监视 → 搜索/分析/导出都已就绪后续可按需接入 PostgreSQL 后端agentsview pg serve或远程访问配置扩展部署形态。【免费下载链接】agentsviewLocal-first session search, analytics, insights, and token use statistics for coding agents, supporting Claude Code, Codex, and more than 20 other agents.项目地址: https://gitcode.com/GitHub_Trending/ag/agentsview创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 AgentsView 快速上手：从安装、启动到自定义配置的完整实战指南
AgentsView 快速上手从安装、启动到自定义配置的完整实战指南【免费下载链接】agentsviewLocal-first session search, analytics, insights, and token use statistics for coding agents, supporting Claude Code, Codex, and more than 20 other agents.项目地址: https://gitcode.com/GitHub_Trending/ag/agentsview本文为 AgentsView一款面向 Claude Code、Codex 等 20 余种编码 Agent 的本地优先会话搜索、分析与 Token 用量统计工具的快速上手指南。读完你可以选择最适合的安装方式桌面应用、PyPI、Shell 脚本、源码编译或 Docker部署 AgentsView理解serve与daemon两种运行模式的生命周期并通过环境变量或配置文件把会话目录指向自定义路径包括 S3 兼容存储最终获得一个可搜索、可分析、可导出的 Agent 会话仪表盘。安装 AgentsViewAgentsView 提供 5 种安装途径按场景选择即可。桌面应用Desktop App在 macOS 上最便捷的安装方式是 Homebrew Caskbrew install --cask agentsview在 Windows 和 Linux 上也可作为 macOS 的替代方案从项目的 GitHub Releases 页面下载最新的.dmg、.exe或.AppImage安装包。桌面应用是完全自包含的打包产物——无需 CLI、无额外依赖并内置自动更新能力。桌面应用与 CLI 共享同一数据目录~/.agentsview/二者可以任意组合使用完全互补而非互斥。macOS 上的行为细节关闭桌面窗口只是隐藏窗口并不会退出 AgentsView。你需要通过菜单栏状态项来重新显示窗口、打开日志文件夹、检查更新或退出桌面应用及其托管的后端进程。pip / uvxpip install agentsview # 永久安装 uvx agentsview # 或不安装直接运行PyPI 上发布了平台专属 wheel覆盖Linuxx86_64、aarch64macOSx86_64、arm64Windowsx86_64、arm64Shell 安装脚本curl -fsSL https://agentsview.io/install.sh | bashWindowsPowerShellpowershell -ExecutionPolicy ByPass -c irm https://agentsview.io/install.ps1 | iex安装器的工作流程可以从 scripts/install.sh 源码中确认检测 OS 与架构detect_os支持Darwindarwin和Linuxlinuxdetect_arch将x86_64/amd64映射为amd64、aarch64/arm64映射为arm64解析最新版本号通过/releases/latest的 302 跳转获取标签版本而非走有速率限制的 GitHub API校验 SHA-256 校验和verify_checksum函数对照发布附带的SHA256SUMS文件校验二进制校验失败会直接终止安装可用AGENTSVIEW_SKIP_CHECKSUM1跳过但不推荐安装二进制优先写入/usr/local/bin若可写否则回退到~/.local/bin。Windows on ARM 说明安装器在 ARM 版 Windows 上优先使用原生arm64构建若该发布版本尚无 arm64 构建则回退到x86_64构建依靠 Windows 自带的 x64 模拟运行。想要原生二进制时可以自行从源码构建。从源码构建Build from Source前置要求以 go.mod 为准Go 1.27需开启 CGO和Node.js 24.11git clone https://gitcode.com/GitHub_Trending/ag/agentsview cd agentsview make build make install # 安装到 ~/.local/bin结合 Makefile 源码可以进一步理解这两条命令在做什么make build先执行pricing-snapshot从制品分支恢复内嵌的 LiteLLM 价格快照和frontendnpm ci npm run build并将产物拷贝到internal/web/dist供go:embed嵌入然后执行CGO_ENABLED1 go build -tags fts5 -ldflags$(LDFLAGS) -o agentsview ./cmd/agentsviewCGO是必需的因为 SQLite 驱动基于mattn/go-sqlite3的 C 绑定见go.mod依赖fts5构建标签启用全文搜索能力。Makefile 中还特意导出了CGO_CFLAGS指向 go-sqlite3 自带的 amalgamation 头文件目录避免使用系统 SDK 里可能与静态链接版本不一致的sqlite3.h该处注释说明头文件不匹配会导致编译告警甚至查询慢 2-3 倍。make install基于build-release优化且 strip并采用先写临时文件再原子 rename的方式落地到~/.local/bin——Makefile 注释解释原子替换会产生新 inode可避免 macOS 上旧进程仍在运行时覆盖二进制导致的 code-signature 校验 SIGKILL 问题。Windows on ARM 手动构建Windows 上没有make且 CGO 需要能编译aarch64目标的 C 编译器。请安装Windows/ARM64 版本的 GoNode.jsaarch64 的llvm-mingw工具链自包含的 clang 运行时无需 Visual Studio 或 Windows SDK。然后在 PowerShell 中手动构建git clone https://gitcode.com/GitHub_Trending/ag/agentsview cd agentsview # 1. 构建前端并嵌入 cd frontend; npm ci; npm run build; cd .. Copy-Item -Recurse -Force frontend/dist internal/web/dist # 2. 使用 aarch64 工具链编译 $env:CGO_ENABLED 1 $env:CC C:\path\to\llvm-mingw\bin\aarch64-w64-mingw32-clang.exe go build -tags fts5 -o agentsview.exe ./cmd/agentsview产物agentsview.exe是原生 ARM64 二进制。大多数用户不需要这样做——安装脚本和 PyPI wheel 都提供原生 arm64 构建——但这对开发调试或运行未发布的功能很有用。Docker每个 tag 发布和 main 分支推送都会向 GitHub Container Registry 发布linux/amd64与linux/arm64双架构镜像docker run --rm -p 127.0.0.1:8080:8080 \ -v agentsview-data:/data \ -v $HOME/.claude/projects:/assets/static/agents/claude:ro \ -e CLAUDE_PROJECTS_DIR/assets/static/agents/claude \ ghcr.io/kenn-io/agentsview:latest容器入口脚本 docker-entrypoint.sh 的逻辑很简单默认执行agentsview serve当设置PG_SERVE1或其等价真值时切换到agentsview pg serve——同一个镜像同时支持本地 SQLite 归档模式和 PostgreSQL 后端模式。关键部署要点容器内的 AgentsView 只能看到你显式 bind-mount 进去的 Agent 会话目录。请把每个 Agent 的会话根目录以只读方式挂载并把对应的目录环境变量指向容器内路径如上例中的CLAUDE_PROJECTS_DIR。/data卷在容器内归 root 所有建议优先使用命名卷named volume而非宿主机 bind mount若必须用宿主机目录请预先创建并设置好属主。仓库提供了生产风格的 Compose 示例 docker-compose.prod.yaml使用命名卷持久化/data只读挂载 Claude、Codex、OpenCode以及 Forge的会话根目录并将 UI 发布在127.0.0.1:8080docker compose -f docker-compose.prod.yaml up -d该示例仅将 UI 发布到回环地址。若要对外暴露请同时启用 bearer-token 认证并有意识地规划端口发布。PostgreSQL 后端部署时让容器指向共享数据库即可docker run --rm -p 127.0.0.1:8080:8080 \ -e PG_SERVE1 \ -e AGENTSVIEW_PG_URLpostgres://user:passwordhost:5432/agentsview?sslmoderequire \ ghcr.io/kenn-io/agentsview:latest运行桌面应用会自动处理启动流程附着到已存在的本地 daemon或后台启动一个然后打开发现的 URL。daemon 与 CLI 命令共享可能比桌面窗口存活更久当没有客户端请求或 daemon 拥有的任务活动时它会在空闲一段时间后自行退出。CLI 用户可以显式启动 Web UIagentsview serve裸agentsview serve在前台运行直到CtrlC。若已有兼容的服务器在运行它会报告该服务器的 URL 并直接退出。启动后它会依次在~/.agentsview/sessions.db初始化 SQLite 数据库发现并同步所有受支持的 Agent的会话开始监视会话目录的变化在http://127.0.0.1:8080启动 Web UI。在浏览器中打开http://127.0.0.1:8080。加--no-browser可禁用自动打开浏览器。也可以在后台启动同一服务器使其在 shell 退出后继续运行agentsview daemon start agentsview daemon status agentsview daemon restart agentsview daemon stopdaemon 包含 Web UI、API、会话同步和文件监视器——daemon start之后不需要再运行serve。daemon stop或serve stop会同时关闭 Web UI 和同步serve stop还会停止同一数据目录下的只读镜像服务器。几个从源码可验证的运行细节daemon start与daemon restart使用来自config.toml和支持的环境变量的正常生效配置不接受 serve 专属标志daemon restart在 daemon 已停止时也会将其启动并保持附着报告启动阶段直到替换 daemon 就绪CtrlC只是停止等待不会终止子进程之后可用agentsview daemon status检查。原有的agentsview serve --background、agentsview serve status、agentsview serve stop依然可用。当一次性 daemon 需要 serve 专属标志时例如--no-sync或未经认证的--host非回环覆盖使用serve --background。--no-sync是仅运行时标志无法写入config.toml参见 cmd/agentsview/cli.go 中no-sync标志的定义与NoSyncExplicit处理。并非每条 CLI 命令都需要常驻服务器只读命令在 daemon 热态时附着它否则直接以只读模式读取本地归档需要新数据或写操作的命令包括sync、usage、token-use、pg push、duckdb push会按需自动启动分离式 daemon且命令结束后服务器继续运行。对于必须不留下后台服务器的脚本或 CI 任务先停掉 daemon再运行AGENTSVIEW_NO_DAEMON1 agentsview sync该设置在 cmd/agentsview/cli.go 中被引用仅禁用自动启动不会停止已运行的 daemon也不会绕过其归档锁。自定义覆盖端口与主机agentsview serve --port 9090 agentsview serve --host 0.0.0.0 --port 3000 agentsview serve --no-browser # 禁用浏览器自动打开 agentsview serve --background --no-sync # 一次性、标志驱动的后台运行转发型开发环境提示如果你通过 exe.dev、Codespaces、Coder、WSL2、SSH 端口转发或反向代理访问 AgentsView请设置--public-url为浏览器实际访问的精确 origin 重启 CLI例如agentsview serve --public-url https://vm.exe.xyz仪表盘闪一下随后出现设置或 API 错误通常意味着服务器拒绝了转发的 host 或 origin——只要/api/v1/settings没有返回401就不是缺少认证 token 的问题。详见 Remote Access。从源码看--public-url会被校验必须包含 host并参与公开 origin 的解析参见 cmd/agentsview/managed_caddy.go 中rewriteConfiguredPublicURLPort等处理逻辑其解析路径在 cmd/agentsview/main_test.go 有覆盖测试。指向自定义会话目录各 Agent 的会话根目录可用环境变量覆盖。注意Aider 没有默认发现根必须设置AIDER_DIR才会扫描其日志export AIDER_DIR~/code export AMP_DIR~/custom/amp/threads # 仅历史本地 Amp 线程 export ANTIGRAVITY_DIR~/custom/antigravity export ANTIGRAVITY_CLI_DIR~/custom/antigravity-cli export CLAUDE_PROJECTS_DIR~/custom/claude/projects export COWORK_DIR~/custom/cowork export CODEX_SESSIONS_DIR~/custom/codex/sessions export COMMANDCODE_PROJECTS_DIR~/custom/commandcode/projects export COPILOT_DIR~/custom/copilot export CORTEX_DIR~/custom/cortex export CURSOR_PROJECTS_DIR~/custom/cursor/projects export DEEPSEEK_TUI_SESSIONS_DIR~/custom/deepseek/sessions export DEEPSEEK_HARNESS_SESSIONS_DIR~/custom/deepseek-harness/sessions export FORGE_DIR~/custom/forge export GEMINI_DIR~/custom/gemini export GOOSE_PATH_ROOT~/custom/goose export GPTME_DIR~/custom/gptme/logs export GROK_DIR~/custom/grok/sessions export HERMES_SESSIONS_DIR~/custom/hermes export IFLOW_DIR~/custom/iflow/projects export KILO_DIR~/custom/kilo export KILO_LEGACY_DIR~/custom/kilo-legacy export KIMI_DIR~/custom/kimi/sessions export KIMI_WORK_DIR~/custom/kimi-work/sessions export KIRO_SESSIONS_DIR~/custom/kiro export KIRO_IDE_DIR~/custom/kiro-ide export MIMOCODE_DIR~/custom/mimocode export VIBE_SESSIONS_DIR~/custom/vibe/logs/session export OMP_DIR~/custom/omp/sessions export OPENCLAW_DIR~/custom/openclaw/agents export OPENCODE_DIR~/custom/opencode export OPENCODEREVIEW_DIR~/custom/opencodereview/sessions export OPENHANDS_CONVERSATIONS_DIR~/custom/openhands export PI_DIR~/custom/pi/sessions export PIEBALD_DIR~/custom/piebald export POOLSIDE_DIR~/custom/poolside/trajectories export POSITRON_DIR~/custom/positron export QCLAW_DIR~/custom/qclaw/agents export QODER_PROJECTS_DIR~/custom/qoder/projects export QWEN_PROJECTS_DIR~/custom/qwen/projects export QWENPAW_DIR~/custom/qwenpaw export REASONIX_DIR~/custom/reasonix export ROOCODE_DIR~/custom/roocode export SHELLEY_DIR~/custom/shelley export TRAE_DIR~/custom/trae/User export VISUALSTUDIO_COPILOT_DIR~/custom/visualstudio-copilot/traces export VSCODE_COPILOT_DIR~/custom/vscode export WINDSURF_DIR~/custom/windsurf/User export WARP_DIR~/custom/warp export WORKBUDDY_PROJECTS_DIR~/custom/workbuddy/projects export ZCODE_DIR~/custom/zcode/cli export ZED_DIR~/custom/zed export ZENCODER_DIR~/custom/zencoder/sessions agentsview serve这些环境变量与config.toml中agents.id.dirs的关系规则详见 docs/configuration.md 的 Session Discovery 一节环境变量优先于配置键显式置空数组如agents.grok.dirs []会清除该 Agent 的默认本地目录省略该键则保持默认目录。S3 兼容会话源Claude / Codex / Cursor对 Claude、Codex 和 Cursor自定义根目录还接受s3://URI[agents.claude] dirs [s3://agent-archive/laptop/raw/claude] [agents.codex] dirs [s3://agent-archive/laptop/raw/codex] [agents.cursor] dirs [s3://agent-archive/laptop/raw/cursor]启动前需设置AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_REGION以及可选的AWS_S3_ENDPOINT用于指向 S3 兼容端点。预期的对象布局与同步行为参见 S3 兼容会话源 文档。你会看到什么服务运行起来后Web UI 提供会话列表支持按项目、Agent、日期、消息数过滤消息查看器完整内容、工具调用与 thinking 块会话智能健康等级、结果判定与信号面板全文搜索覆盖所有消息内容分析活动热力图、工具使用率、速度图表活动报告并发度、agent-minutes、成本与会话行明细会话导出导出为独立 HTML、用于 Agent 交接的 markdown 导出链接或 GitHub Gist。在全文搜索之外可选的语义搜索让agentsview session search --semantic或--hybrid按含义匹配会话内容由本地或托管的 embeddings 端点提供支撑具体配置见 Semantic Search 文档。至此无论选择哪种安装与运行方式AgentsView 的核心工作流发现 → 同步 → 监视 → 搜索/分析/导出都已就绪后续可按需接入 PostgreSQL 后端agentsview pg serve或远程访问配置扩展部署形态。【免费下载链接】agentsviewLocal-first session search, analytics, insights, and token use statistics for coding agents, supporting Claude Code, Codex, and more than 20 other agents.项目地址: https://gitcode.com/GitHub_Trending/ag/agentsview创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考