covo-agent：covoyage推出的Go语言终端开源AI智能体工具

一、covo-agent是什么

covo-agent 是 covoyage 团队开源、基于 Go 语言实现的终端通用AI智能体（AI Agent），采用 AGPL-3.0 开源协议，主打终端TUI交互，兼顾通用知识问答与软件开发两大工作模式。

它不局限简单对话，内置大量工具能力，具备本地持久记忆、操作安全管控、多模型兼容、多扩展协议支持，既可以人工交互式操作，也支持无头模式完成自动化任务，可运行在 Linux、macOS、Windows 全平台，面向开发者、技术运维人员、技术内容工作者。

项目底层依赖 covonaut Go Agent 框架，完整实现工具调用、会话快照、任务委托、可观测追踪整套Agent运行链路。

二、功能特色

1. 三种运行工作模式
   交互式TUI终端界面：流式输出回答，展示工具调用状态，内置会话历史、模型快速切换、主题自定义、Shell自动补全，本地终端沉浸式操作。
   oneshot单次执行模式：适合脚本调用，支持输出JSON结构化结果，适配shell脚本流水线。
   headless无头受控模式：无人工交互全自动运行，可限制工具集合、最大执行轮次、命令黑白名单，用于CI、本地自动化脚本。

2. 面向软件开发的全套工具集
   支持文件检索、读写编辑、补丁应用、shell命令执行、代码评审、单元测试生成、Git worktree操作；提供任务状态检查点快照，执行出错可以回溯恢复；可对接Chrome浏览器获得网页浏览工具能力。

3. 本地持久化记忆与配置体系
   本地磁盘持久存储会话记录、长期记忆、自定义技能、任务快照、用户配置Profile。支持项目级独立配置文件，不同代码仓库可以拥有独立Agent策略；支持多套用户Profile隔离，通过环境变量切换。

4. 广泛大模型后端兼容
   原生对接 OpenAI、Anthropic、Gemini、小米、OpenRouter；同时兼容所有OpenAI接口规范的自定义大模型服务，本地部署模型也可接入使用。

5. 完整安全管控体系
   提供人工操作审批闸门，支持shell命令、文件路径的允许/拒绝黑白名单；密钥自动脱敏、沙箱运行配置、完整审计日志；内置死循环自动熔断保护；提供--yolo参数关闭确认校验（高风险，仅可信环境使用）。

6. 多协议扩展与Agent委托能力
   原生支持 MCP、ACP、LSP、插件、网关扩展；兼容 Claude Code、OpenAI Codex hook协议，可以复用现有脚本；支持external_agent工具，可把子任务委托给外部AI智能体执行。

7. 可观测性链路追踪
   原生集成 OTLP 标准，能够对接 Langfuse、Jaeger 等观测平台，导出完整调用链路Trace、token消耗统计、工具调用指标，方便调试Agent行为。

三、技术细节

1. 开发语言与依赖
   主体代码使用 Go 语言开发，要求编译环境 Go ≥1.25.0；附带少量 Shell、Python辅助脚本；Git为可选依赖，快照、Git相关功能需要Git。

2. 存储架构
   全局配置路径 ~/.covo-agent/config.yaml；项目目录下 .covo-agent.yaml 项目配置会覆盖全局配置；API密钥存放于 ~/.covo-agent/.env；会话、记忆、快照、日志全部存放在 ~/.covo-agent/ 目录；支持环境变量注入YAML配置。

3. 运行架构
   基于 covonaut Go Agent底层框架，负责大模型对话管理、工具调度、记忆管理、安全校验；工具层内置文件、shell、git等原生工具，同时对接MCP/LSP外部工具源；执行层区分交互/单次/无头三套调度逻辑；OTLP模块负责指标链路上报。

4. 跨平台支持
   支持 Linux、macOS、Windows；内置covo-agent doctor环境诊断命令，可自动检测依赖、配置、密钥完整性，部分问题支持自动修复。

5. 开源协议
   AGPL-3.0，修改后对外提供服务需要开源修改后的代码。

四、应用场景

1. 本地软件开发辅助
   在终端内完成代码审查、代码修改、生成单元测试、分析未提交变更，借助快照功能，Agent改动代码后可以随时回滚。

2. 运维自动化脚本
   headless无头模式嵌入shell脚本，完成日志分析、配置修改、简单系统巡检，黑白名单限制高危命令，保障执行安全。

3. 终端交互式AI助手
   不打开网页，直接在终端完成问答、文档解析、命令生成，TUI界面便于查看工具执行全过程。

4. MCP工具生态本地Agent
   对接MCP各类本地工具，把本地文件、数据库、第三方服务能力交给Agent调用。

5. CI流水线集成
   oneshot模式接入CI，完成代码评审、变更风险检测，输出JSON格式结果供流水线解析。

6. 研究与二次开发
   Go语言Agent框架参考项目，可基于covonaut框架二次开发定制终端智能体。

五、使用方法

环境前置

• Go 1.25.0（源码编译需要）

• 至少一个大模型服务商API Key

• Git（推荐，快照Git相关功能需要）

安装方式

# 一键脚本安装
curl -fsSL https://raw.githubusercontent.com/covoyage/covo-agent/main/install.sh | bash

# Homebrew(macOS/Linux)
brew install --cask covoyage/tap/covo-agent

# Go install直接安装最新版
go install github.com/covoyage/covo-agent/cmd/covo-agent@latest

Windows使用Scoop添加bucket后安装，也可以clone源码手动编译二进制。

基础操作

# 初始化配置，设置模型参数
covo-agent setup

# 添加模型服务商密钥
covo-agent auth add

# 启动交互式TUI界面（当前项目）
covo-agent

# 单次执行，输出结构化结果
covo-agent --oneshot "review uncommitted changes"

# 环境诊断，部分问题自动修复
covo-agent doctor --fix

配置说明

1. 全局配置：~/.covo-agent/config.yaml

2. 项目配置：项目文件夹创建 .covo-agent.yaml，会覆盖全局配置

3. 多Profile切换：环境变量COVO_PROFILE指定不同配置隔离工作环境

六、竞品对比

选取Aider、Claude Code、Open-Agent，从运行载体、语言、记忆持久化、无头自动化、扩展协议、开源协议进行对比。

说明：Aider是成熟终端编码Agent；Claude Code为Anthropic闭源产品；covo-agent优势在于Go高性能、完整快照检查点、多Profile隔离、原生OTLP可观测，完整支持无头自动化。

七、常见问题解答

covo-agent必须使用Go编译运行吗？

不需要，官方提供各平台预编译二进制包，一键脚本、brew、scoop可以直接安装使用；只有源码编译才需要Go ≥1.25.0环境。

是否支持本地私有化大模型？

支持，只要服务兼容OpenAI接口规范，填写自定义base_url和API密钥即可接入本地模型。

--yolo参数是什么，是否建议日常开启？

--yolo会关闭shell命令、文件操作人工确认闸门，Agent可以直接执行高危操作，仅在完全可信隔离环境使用，日常工作不建议开启。

项目配置文件不生效是什么原因？

确认项目目录存在.covo-agent.yaml，YAML语法无错误；项目配置优先级高于全局配置；可以执行covo-agent doctor检测配置文件。

会话记忆保存在哪里，如何清除？

会话、记忆、快照存储在~/.covo-agent/目录，删除对应目录文件即可清理；也可以使用内置session、memory子命令管理记忆。

可以在CI流水线中使用covo-agent吗？

可以，使用--oneshot或者--headless无头模式，配合工具黑白名单限制权限，输出JSON格式便于流水线解析。

MCP工具如何接入covo-agent？

使用covo-agent mcp系列子命令配置MCP服务，在配置文件声明MCP服务地址即可加载外部MCP工具。

八、相关链接

• GitHub仓库：https://github.com/covoyage/covo-agent

九、总结

covo-agent是一款Go语言构建的开源终端AI Agent，兼顾交互式使用与自动化执行，完整实现本地持久记忆、安全权限管控、多协议扩展、链路观测能力，适配软件开发、运维自动化、CI流水线等多种本地终端场景，兼容主流以及OpenAI兼容的各类大模型，AGPL-3.0开源协议允许开发者自由使用与二次修改，适合需要在终端环境部署AI智能体的技术人员。