agentengine 调试日志

Synopsis

查看 CLI 自身的调试日志。

每次调用都会写入一个结构化的 JSON 日志文件，除非设置了 --no-log。日志文件位于：

• macOS： ~/Library/Logs/agentengine/

• Linux: ${XDG_STATE_HOME:-~/.local/state}/agentengine/logs/

• Windows： %LOCALAPPDATA%\agentengine\Logs\

标志及其环境变量：

--log-level 日志 AGENTENGINE_LOG_LEVEL（默认 info） --log-file 日志文件 AGENTENGINE_LOG_FILE --no-log 日志 AGENTENGINE_NO_LOG --verbose -v, -vv 提高 stderr 详细程度 --quiet -q 抑制 error 以下的 stderr

AGENTENGINE_LOG_MAX_FILES 设置保留文件数（默认 20）。AGENTENGINE_NO_LOG_PRUNE 禁用自动清理。

当命令失败时，最后一行 stderr 会显示活动日志路径：

详情请参阅：~/Library/库/Logs/日志/agentengine/agentengine-2026-05-13T11-43-57Z-12345.log

例子：

agentengine debug logs listagentengine debug logs get --last --pretty

选项

-h, --help   help for logs

从父命令继承的选项

    --log-file string    override log file path    --log-level string   file log verbosity (error|warn|info|debug) (default "info")    --no-log             disable file logging-q, --quiet              silence stderr below error-v, --verbose count      raise stderr verbosity (-v info, -vv debug)

另请参阅

• agentengine debug - CLI 调试日志。

• agentengine debug logs get - 打印日志文件。

• agentengine 调试日志列表 - 列出日志文件，按时间从新到旧排序。