# @cogit/cli 中文文档

规范地址：https://npmcn.com/package/%40cogit/cli/

版本：1\.3\.1
npm 元数据更新时间：2026-11-09T05:16:22.173Z
中文译文更新时间：2026-11-10T09:49:56.245Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40cogit/cli
原文对照：https://npmcn.com/package/%40cogit/cli/?lang=original
项目主页：https://github.com/erensrtky/cogit#readme
源码仓库：https://github.com/erensrtky/cogit

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：5.6 MB，10 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.13\.0
- 运行依赖：0 个
- 首次发布：2026-10-28T00:14:43.637Z
- 最新版本发布：2026-11-09T05:16:21.910Z
- 近 30 天下载量：7152（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：38（近 12 个月 38 个）

## 中文简介

是因为代理密码背后的意图.

## 安装

```sh
npm install @cogit/cli
```

也可以使用：`pnpm add @cogit/cli`、`yarn add @cogit/cli`、`bun add @cogit/cli`

## README

![cogit](https://npmcn.com/package/%40cogit/cli/docs/images/cogit-mark.svg)

# 鸡尾酒

**是因为代理密码背后的意图.**

![René Descartes with git branches running through his hair](https://npmcn.com/package/%40cogit/cli/docs/images/cogit-descartes.jpg)  
_科吉多,埃尔戈承诺._

cogit 记录您发送到 AI 编码代理服务器的每封信 _思想承诺_: 你怎么样 问其来由,所应之旨. 您的代码输入到 在他们身后思考,所以 `cogit why` 将任意一行代码带回它存在的原因。 有用吗 与克劳德代码今天.

代理记忆帮助你的代理记忆。 科吉特帮助你理解.

它作为一个 Claude 代码插件运行,并且通过 Claude 代码钩子工作,所以记录被写入 在你工作的时候, 之后没有从 diff 重建.

**[通过已保存的地图单击](https://erensrtky.github.io/cogit/demo/)**: 没有安装, 没有服务器 . 这是一页 `cogit open` 写入,由样本数据构建,只读.

## 为什么

我首先从ChatGPT复制代码,然后移动到浏览器工具,编辑扩展,现在 终端特工. 每一步都把密码移得越远 我就越觉得 渐渐地消失。 当你自己写代码时,它会逐个下沉: 你知道为什么那张桌子 以及你为什么写那个课 当经纪人写的时候 感觉就消失了.

信息并没有真正消失。 它坐在你的信息, 代理的答复和你的承诺, 在不同的地点。 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}所以你总能走回来看看为什么 有些事情已经做了。 这对你们拼凑项目最有帮助:我马上管理5 -10个特工,跨越2 -3 几分钟后,我就会失去我的行踪.

![A conceptual chart from machine code to software factories: abstraction keeps rising, while how much of the why you can still trace falls sharply once AI starts writing code. cogit keeps what falls away.](https://npmcn.com/package/%40cogit/cli/docs/images/why-abstraction.png)

它比一个人的记忆要大:一个评论家看到什么变化,而不是为什么. [更多,有研究和来源](https://npmcn.com/package/%40cogit/cli/docs/guide/why.md)。 。 。 .

科吉特不是: 科吉特(英语:

-   **代理内存** 这帮助你的经纪人回忆起你说过的话.
-   **符号保护器** (RTK,主厅):发送模型较少.
-   **代码映射** (图解):这说明一个代码库是如何组合在一起的.
-   **一个指挥家** (赫德,指挥员):它同时管理着许多特工.
-   **规划框架** (BMAD,Spec Kit):这决定了下一步要建造什么.
-   **一个AI审查机器人** (CodeRabbit, Greptile):关于diff看起来是否正确的评论.

它回答了他们留下的一个问题:为什么这个代码是这样的? 我用几个 他们与它并肩作战.

## 看见了

![The map: sessions as a git graph, each with its messages, branches, commit chips and a left off here marker](https://npmcn.com/package/%40cogit/cli/docs/images/map.png)

_你的会话作为图表 每一个消息一行,它背后的决定,以及你离开的地方 关闭._

![A message opened on its Shape tab: a flowchart of what the change does, under the tabs Intent, Shape and Code](https://npmcn.com/package/%40cogit/cli/docs/images/shape.png)

_登陆的讯息以意向、形状和代码打开:为什么会发生 变化是做什么的, 和diff._

![The Tasks panel: suggested items with Accept and Dismiss, open items with Done, and a Done section](https://npmcn.com/package/%40cogit/cli/docs/images/tasks.png)

_任务——工作在会话中出现,没有完成,会话结束后被抓住. 你接受 驳回 或关闭每一个._

![The Files view: a changed file opened, listing the messages that touched it with each message's reason and the option it rejected](https://npmcn.com/package/%40cogit/cli/docs/images/files.png)

_一个被改变的文件打开了它的历史:每一个触及它的信息,以及每个信息背后的原因—— 包括被拒绝的选项._

## 它会做什么

-   **每条信息都成为思想承诺**问题、结果、决定 他们的理由和被拒绝的选择,以及它先前继续传达的信息.
-   **您的会话地图**: 显示您与分支,决定, a “ 轮到你” 收件箱, 以及复制命令以重开聊天或 继续作为新的.
-   **交代他们的理由**(单位:千美元) `Thought:` 在每次行动上拖走; `cogit show <sha>`, (中文(简体) ), `cogit blame` 财务报告和审定财务报表 `cogit why` 跟着它走.
-   **意图、形状、代码**:一个落地的消息 显示它为什么会发生,一个小 图片 变化的作用(图、表前/表后或界面表,例) 或平地步),而地道(diff),在一个地方.
-   **任务**:当一个会场结束, 一个小模型抓住了 的作品,没有得到 完成为几个用户级的项目; 您接受、 排除或关闭这些项目(`cogit captures`,以及 在地图上.
-   **将请求描述与决定**数字 : `cogit pr` 写目标、目标 裁决和被拒绝的选项,永远不要原始聊天. `cogit pr --install-action` 添加a GitHub 动作会把它们张贴在每一个拉出请求上.
-   **团队通过 git 分享记录**:经过拉动,你的队友的会话在 地图,谁管理它们,什么改变最大.
-   **经纪人自己的原因,或者最便宜的记录**: 在 并永不中断代理。 默认情况下, 当会话结束时, 它运行的模型 重开整个对话 用只看到的东西来纠正记录 还有一个消息。 经济问题让小模型决定:每20条信息不到2分 在我们的衡量.
-   **没有服务器, 没有账户**它运行在你的机器上。 除非你这么说 否则什么也不会留下 `cogit init` 询问是否与您的团队分享记录(标题、决定和理由)。 狦 来, `git push` 寄到你自己的仓库,在你的分行外, 所以它从来没有出现在 牵引请求或 `git status`。您的聊天会留在本地, `cogit prune` 删除旧会话,并 键和符号图案被编辑.
-   **代理也得到上下文**: 一个新的会话开始于最后一个会话离开的地方,以及 在编辑一个文件之前, 代理听到已经尝试和拒绝的内容。 有用吗 与内存工具并列;它不会取代它们.

## 安装

你需要22.13+节点,克洛德代码2.1.275+和一个git寄存器.

```bash
npm install -g @cogit/cli
```

然后,在克洛德代码:

```text
/plugin install cogit --marketplace erensrtky/cogit
```

要获得插件更新, 打开自动更新一次 : `/plugin` 市场 启用自动更新 。 Claude Code把它留给自己以外的市场.

如果地图仍为空, 请运行 `cogit doctor`。 。 。 .

## 快开始

```bash
cd your-project
cogit init        # a few questions: git, transcript retention, team setup, language
```

和Claude Code一样合作 录音不需要你帮忙 然后打开地图 :

```bash
cogit open .
```

## 指南

-   [开始](https://npmcn.com/package/%40cogit/cli/docs/guide/getting-started.md): 内容 `init` 问,你的第一次会话, 建立团队
-   [地图](https://npmcn.com/package/%40cogit/cli/docs/guide/map.md): 会话、分支、收件箱、文件、搜索、, a. 恢复和召集会议
-   [读取家族](https://npmcn.com/package/%40cogit/cli/docs/guide/reading-the-lineage.md)数字 : `log`, (中文(简体) ), `show`, (中文(简体) ), `blame`, (中文(简体) ), `why`, (中文(简体) ), `search`
-   [调取请求](https://npmcn.com/package/%40cogit/cli/docs/guide/pull-requests.md)数字 : `cogit pr`
-   [团队和基特](https://npmcn.com/package/%40cogit/cli/docs/guide/teams-and-git.md):什么是共享的,拖车,钩子
-   [记录和费用](https://npmcn.com/package/%40cogit/cli/docs/guide/recording-and-cost.md):谁写记录,是什么 费用
-   [隐私](https://npmcn.com/package/%40cogit/cli/docs/guide/privacy.md):什么被记录,什么永远不会离开你的机器
-   [设置](https://npmcn.com/package/%40cogit/cli/docs/guide/settings.md): 每个设置, 解释
-   [解决问题](https://npmcn.com/package/%40cogit/cli/docs/guide/troubleshooting.md)
-   [财务问题](https://npmcn.com/package/%40cogit/cli/docs/guide/faq.md):有人在发射后提问
-   [为什么是科吉特](https://npmcn.com/package/%40cogit/cli/docs/guide/why.md):AI使代码更快,审查更慢

记录格式为 [文件/格式.md](https://npmcn.com/package/%40cogit/cli/docs/format.md)。 。 。 .

## 许可证

麻省理工学院——见 [自由主义](https://npmcn.com/package/%40cogit/cli/LICENSE)。 。 。 .

## 常见问题

### @cogit/cli 是什么？

是因为代理密码背后的意图\.

### 如何安装 @cogit/cli？

在项目目录运行 npm install @cogit/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cogit，可以用 npx cogit 直接运行。

### @cogit/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cogit\_\_cli 是否存在。

### @cogit/cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @cogit/cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.13\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @cogit/cli 可以商用吗？

@cogit/cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @cogit/cli 的下载量有多少？

根据 npm 官方下载统计，@cogit/cli 在 2026/10/11 – 2026/11/09 这 30 天内被下载 7,152 次，日均约 238 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @cogit/cli 还在维护吗？

最新版本 1\.3\.1 发布于 2026/11/09（1 天前）；至今共发布 38 个版本，其中过去 12 个月发布了 38 个；首次发布于 2026/10/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。