签名溯源
追踪会话
Git 时间旅行
可回放会话
IDE 风格 Tab 自动补全
Agensic 为 AI 时代升级您现有的终端工作流。它专为追求 AI 代理在 shell 中带来的生产力提升、但不愿在可审计性、控制和隐私上妥协的开发者打造。
随着 AI 代理越来越多地接管命令行并自主执行任务，可见性和控制力变得至关重要。 Agensic 将终端命令视为一等公民，并提供一个强大的框架来追踪、检查和管理它们。
Agensic 并未将所有终端活动扁平化为单一的模糊“shell 历史”，而是作为一位取证观察者和一个智能副驾驶。它无缝追踪交互式 AI 编码会话，对代理执行的命令进行加密签名，并提供快速、基于历史的 IDE 风格 Tab 自动补全。
Agensic 旨在深度集成到您的 shell 环境中。
macOS (Zsh) — 完全支持 ✅
Linux (Bash) — 完全支持 ✅
最快的方式是使用管理的一行安装程序：
curl -fsSL https://raw.githubusercontent.com/Alex188dot/agensic/main/bootstrap.sh | bash
如果您更喜欢手动克隆：
git clone https://github.com/Alex188dot/agensic.git
cd agensic
bash ./install.sh
如果您已经安装了 uv，安装程序会自动使用它来加快设置。
首次运行时，Agensic 会提示您选择首选的 LLM 提供商并配置用于命令自动补全的 API 密钥。
或者，您也可以通过运行以下命令来配置 LLM 提供商和 API 密钥：
agensic setup
设置完成后，打开一个新的终端，Agensic 会自动开始追踪您的终端活动，并在您输入时提供自动补全建议！
像往常一样开始工作，例如使用您最喜欢的 AI 编码助手，如 Claude Code、Codex CLI 等：
claude
或
codex
查看支持的代理部分以获取所有支持代理的完整列表。如果您的代理不在列表中，您可以通过运行 agensic --add_agent "可执行文件" 来添加它，然后正常使用，以便 Agensic 能追踪它。
完成后，您可以使用 Agensic 检查会话历史：
agensic sessions
或查看取证溯源：
agensic provenance
Agensic 为每条命令提供一个取证记录。它对发生的事件进行分类，记录丰富的元数据，并提供清晰的审计轨迹，让您能够判断命令是手动输入的、从建议中接受的，还是直接由代理执行的。
需要回答“这里到底运行了什么，以及谁触发了它？”运行 agensic provenance 打开全屏溯源查看器。按标签、代理、提供商或时间窗口过滤，检查确切的命令轨迹，并在需要为调试、事件审查或合规保留持久记录时，将当前视图导出为 JSON 或 CSV。
别再猜测是人类还是 AI 破坏了构建。Agensic 为每条命令捕获丰富的元数据，并使用本地 Ed25519 签名为代理执行的运行打上不可否认的 AI_EXECUTED 标签。您将得到一个清晰的、可审计的时间线，将人类击键与 AI 建议以及自动执行区分开来。
Agensic 不会将终端历史简化为原始字符串列表。每条被追踪的命令都被归类为一个溯源标签，为您提供一致的方式来过滤运行、调查行为并理解命令最初是如何进入您的 shell 的。
Agensic 目前支持以下溯源标签：
AI_EXECUTED 用于由 AI 代理直接执行并带有签名证明的命令HUMAN_TYPED 用于人类在 shell 中手动输入的命令AI_SUGGESTED_HUMAN_RAN 用于由外部 AI LLM 调用建议并由人类执行的命令AG_SUGGESTED_HUMAN_RAN 用于由 Agensic 建议并由人类执行的命令INVALID_PROOF 用于带有证明元数据但验证失败的命令UNKNOWN 用于现有证据不足以分配更强归因标签的命令Agensic 记录交互式代理会话，为您提供所发生事件的无可辩驳的证据，并能够通过时间旅行功能安全地操作仓库状态。
需要审计昨晚的会话以了解发生了什么？运行 agensic sessions 并选择您想要回放的会话。我们快速的全屏 TUI 让您可以立即浏览时间线、检查并回放会话。当您需要为事件审查共享证据时，一键将精确的数据集导出为 JSON 或 CSV。
是否曾想过“在代理做出破坏性提交之前，我的仓库确切状态是什么？”时间旅行让您将仓库倒回到在特定会话检查点捕获的确切 Git 状态。Agensic 安全地将未追踪和已修改的文件恢复到一个全新的分支中，确保您在调查时绝不会意外破坏当前的工作树。
您的数据属于您。Agensic 使用一个健壮的 SQLite 状态后端，带有一个仅追加的事件日志和自动化快照。这意味着您的取证历史能够无损坏地经受意外的终端崩溃、系统重启和长期本地使用。
Agensic 提供一组预配置的内置代理，可以对其进行追踪：
自定义代理：在 Agensic 设置中插入任意代理可执行文件，它会立即工作，无需额外配置。
Agensic 重新构想了终端建议。上下文感知、语义化、始终快速且具有 IDE 风格、令人满意的 Tab 自动补全。
告别输入延迟。当您输入时，Agensic 查询您实际命令历史的存储。建议以幽灵文本的形式立即出现，您可以通过 Tab 轻松接受。因为它从您的模式中学习，并依赖于您的实际操作，所以建议非常准确且对仓库有感知。
人类会犯错，Agensic 会修复。如果您输入 dokcer，Agensic 会立即建议 您的意思是：docker。记不清确切的语法？语义重排序会拯救您的意图，即使您的前缀不完美也能找到正确的命令：如果您输入 docker records，您会得到 您的意思是：docker logs（前提是您之前运行过 docker logs）。
AI 是一个强大的回退方案，而不是每次击键的负担。Agensic 实行每行 LLM 预算以防止提示词泛滥。当本地历史不足时，会自动触发 LLM 回退。或者，您也可以随时按 Ctrl+Space 手动从您偏好的本地或托管 LLM 获取智能建议。
忘记确切的语法，只需描述您想要什么。输入类似：# 如何找到此文件夹中所有大于 10MB 的文件？。Agensic 会生成 3 个可以直接复制的 shell 命令，并将最可能的选项直接插入到您的下一行。需要指导而不是命令？使用助手模式直接在终端中获得分步答案：## 如何在 macOS 上安装 Node？。想先理解命令再运行？使用：agensic --explain "您的命令"
Agensic 尊重您的终端。当您在补全文件路径或脚本时，它让 Tab 保持原样，因此原生 shell 补全在最佳场景下仍能胜出。更重要的是，破坏性命令（如 rm -rf、mkfs 或 dd）被严格阻止纳入建议池，这样您永远不会意外执行灾难性操作。
Agensic 适合您的技术栈，无论您在本地运行模型还是使用托管端点。
下表列出了 Agensic 当前可用的每个 CLI 命令。
Agensic 遵循最小权限和最大隐私原则：
Alessio Leodori
发现 Agensic 有用？给仓库点个星 ⭐️ 并告诉朋友！这将帮助我们成长 🌱
Agensic 是开源软件，采用 Apache-2.0 许可证。
| 命令 | 作用 |
|---|
agensic --help | 显示主要的 CLI 帮助和所有标准用户面向命令 |
agensic --version | 打印已安装的 Agensic 版本并退出 |
agensic update | 下载并安装最新的已发布 Agensic GitHub 版本 |
agensic setup | 打开 Agensic 会话和自动补全的交互式设置流程 |
agensic enable-startup | 配置 Agensic 在登录或启动时自动启动 |
agensic first-run | 运行首次安装的引导流程 |
agensic start | 手动启动 Agensic 后台守护进程 |
agensic stop | 停止 Agensic 守护进程 |
agensic logs | 实时追踪守护进程日志输出 |
agensic test | 向守护进程发送测试自动补全请求以验证连接 |
agensic provenance | 打开命令溯源历史视图。支持 --limit、--label 和 --contains 等过滤器 |
agensic sessions | 打开追踪的会话浏览器。使用 --text 获取纯文本输出 |