Skip to content
项目

dozybot001/Intent has 316 GitHub stars and 0 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-19 02:24 UTC. Last push 2026-11-15.

这些数字如何统计

实测星标增长

24小时
0
7天
正在收集历史
15天
正在收集历史
1个月
正在收集历史

各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。

关于

Semantic Git for the vibe coding era

开发工具

README_CN.md

原文

Intent CLI

Vibe Coding 时代的语义版 Git

中文 | English

tests PyPI Python 3.9+ status: beta license: MIT

编码 Agent 记不住你上次做到哪里。Intent 把当前目标、最近一次经过验证的检查点和长期决策保存在项目里,下一次会话可以直接接着做,不用重新摸索。

Git 记录代码怎么变;Intent 记录为什么这样做、哪些已经验证、下一步是什么。

周一的会话记下检查点。周二新开的会话只收到一句“通过 Intent 恢复”,就拿回了目标、已验证状态、规则和下一步。

看一个真实项目:在 IntHub 上浏览 Intent 自己的历史。这里记录着这个仓库背后的目标、检查点和决策,无需登录。

理念

现在你通过 Agent 塑造代码。代码进了 Git,推理却留在对话里,会话一结束就没了。下一个 Agent 从零开始,你只好再讲一遍。

Intent 在代码旁边加了一层很薄的语义历史,核心是一个有意为之的不对称:

  • 记录时很轻。 Agent 只在确实验证了有意义的进展时才记一个检查点,没有变化的轮次什么都不写。
  • 恢复时很全。 一条命令就能让下一次会话拿到目标、已验证状态、工作边界、下一步和仍然有效的规则。

历史是 .intent/ 里的普通 JSON,任何 Agent 都能读,你自己也能读。除非你主动共享,否则数据不会离开你的电脑。

快速开始

# 1. 安装 CLI(macOS / Linux),重复执行即可升级
curl -fsSL https://gitee.com/dozybot/Intent/raw/main/scripts/install.sh | INTENT_REPO=https://gitee.com/dozybot/Intent.git bash

# 2. 安装 Agent Skill(需要 Node.js)
npx skills add https://gitee.com/dozybot/Intent.git -g -a claude-code -a codex -y

# 3. 在项目中启用(Git 可选)
cd your-project
itt init

然后信任一次项目 hooks:Claude Code 中信任该目录,并在 /hooks 确认两个 hook;Codex 中打开 /hooks。之后照常工作。下次继续时,在任何会话里说一句:

通过 Intent 恢复这个项目。

访问 GitHub 顺畅时,也可以把上面两个地址换成 GitHub 版本。 Windows(PowerShell):irm https://raw.githubusercontent.com/dozybot001/Intent/main/scripts/install.ps1 | iex。 使用 pipx 或 uv:pipx install intent-history 或 uv tool install intent-history。需要 Python 3.9+。

几个名字一句话说清:Intent CLI 是产品,itt 是命令,intent-history 是安装包,IntHub 是可选的网页应用。

手动体验

itt init
itt intent create "Add Apple Pay to the web checkout" --why "Apple Pay users convert 2x on mobile Safari"
itt snap create "Payment sheet confirms PaymentIntents in test mode" \
  --next "Handle shipping-method changes server-side" --blocker none
itt decision create "Payments go through the PaymentIntent API only" --why "One SCA path"
itt inspect
Active
  intent-3f9a2c1  Add Apple Pay to the web checkout
                  Next         Handle shipping-method changes server-side
                  Blocker      none
                  Verified     Payment sheet confirms PaymentIntents in test mode
                  snap-8e41d07 · 2026-10-30 00:25 · 1 snap

Decisions
  decision-c27b5fa  Payments go through the PaymentIntent API only

新会话读到的就是这些。在终端中 itt 输出文本,Agent 和脚本得到 JSON。

为什么不只用 AGENTS.md 或 Agent 记忆?

你可能已经在用 它保存的是 Intent 补上的是
AGENTS.md、CLAUDE.md、Cursor rules 在这个仓库里应该怎么工作 工作进行到哪里:当前目标、已验证状态、下一步、阻塞项
Agent 自带的记忆 各工具私有、不透明的笔记 项目里的普通 JSON,任何 Agent 和你自己都能读
Issue、PR、ADR 团队计划与评审 工作过程中留下的检查点,以及会自动关联到新目标的决策
Git 历史 代码改了什么 背后的理由,以及真正完成到哪一步

记录什么

三类对象,全部只追加:

对象 记录什么
Intent 一个目标,以及它为什么重要
Snap 一个经过验证的检查点:已验证什么、工作边界、下一步、阻塞项
Decision 约束后续目标的长期规则,例如「支付只走 PaymentIntent」

Intent 之间可以建立关系:组成、衍生、继承、依赖、对立。IntHub 的「流转」页会画出目标如何分出、接续与汇合(意图流转)。

像 Git 一样的历史

会用 Git,就知道 Intent 怎么工作。每次写入都是一个修订,不需要提交。

itt log --graph               # 修订、分支与合并
itt diff HEAD~3               # 改了什么,按目标和检查点而不是按行
itt switch -c experiment      # 像 Git 一样给历史开分支
itt merge experiment          # 合并回来,只有真正的分歧才会停下

不同 Git worktree 里的 Agent 共享一份历史,各有自己的分支,新 ID 也不会冲突。合并会自动汇总检查点,只有两边把同一字段改成不同的值才会停下,例如一边把目标标记完成,另一边取消了它。详见设计。

支持的 Agent

宿主 支持方式
Claude Code Skill(或插件:/plugin marketplace add dozybot001/Intent,然后 /plugin install intent-cli@intent)加项目 hooks:itt init --host claude-code。见配置与限制。
Codex Skill 加项目 hooks:itt init --host codex。见配置与限制。
Cursor 及其他 Agent 仅 Skill 指令,尽力而为

Hooks 在每一轮开始时注入当前状态,并在结束时检查这一轮是否完成收尾。它们只写入项目内的文件,不会启用其他项目。itt maintenance off 可关闭单个项目的记录。

在还没用 Intent 的项目里,Agent 会问一次是否开启记录,拒绝后不再询问。钩子运行之前,itt status 和 itt inspect 会提示该怎么做。

什么留在你的电脑上

  • .intent/ 保存普通 JSON。由于可能包含内部推理,itt init 只在当前克隆中把它排除出 Git;如果团队希望放进 Git,请有意识地提交。
  • 每个启用 hook 的轮次会注入一段有硬上限的开局上下文,并调用一次 itt maintenance close。
  • itt 只有在你运行 push、pull、fetch、clone、auth,或在配置了远端时运行 status,才访问网络。

用 IntHub 共享(可选)

IntHub 的流转页:目标是一张张卡片,并画出它们的组成、衍生和决策
  • 本地: itt hub start,然后 itt remote add origin http://127.0.0.1:7210 --project NAME 和 itt push。其他目录用 itt clone NAME --api-base-url http://127.0.0.1:7210 加入。
  • 托管: inthub.tenonai.cn,由榫卯 Tenon AI 运营。运行 itt auth login,在浏览器里批准代码,再 itt push。每个账号和团队可以保存 100 个项目和 1 GB 历史。项目默认私有,可以共享给团队(--project 团队/项目),也可以在项目设置里公开。详见团队与共享和隐私说明。
  • 在另一处恢复: 在项目目录运行 itt clone NAME,仅限成员。

itt push 推送当前分支,itt pull 先 fetch 再合并,和 Git 一样。如果两份副本同时记录,itt status 会报告 diverged,itt pull 会合并它们,只有双方把同一字段改成不同值时才停下。

状态

Intent 处于 Beta(8.x)。从 Intent 7 升级时,在每个项目运行一次 itt migrate:它保留所有 ID,并先做备份。同一主版本内,.intent/ 格式与 JSON 输出保持兼容;不兼容的变化只会随新的主版本和迁移一起发布。记录与接续流程在 Python 3.9 至 3.14 上有测试覆盖。Intent 能否在真实工作中明显减少重复解释,仍在用自然接续案例验证。

常见问题

它会取代 Git、Issue 或文档吗? 不会。它记录的是这些工具没有记录的理由和工作状态。

Agent 记录了无用内容怎么办? 零写入是正常结果。Skill 只记录经过验证的里程碑,从不按命令或文件逐条记录。对象只追加,更正以新的 Snap 表达。

pip install intent-cli 是这个项目吗? 不是,PyPI 上的这个名字属于一个无关工具。Intent 的安装包是 intent-history。

支持 Windows 吗? CLI 与安装脚本支持 Windows。Claude Code hooks 需要 Git Bash。

怎么卸载? 在每个项目里运行 itt maintenance off --remove-hooks,如果也想删除历史,再运行 rm -rf .intent。然后运行 rm -rf ~/.local/share/intent ~/.local/bin/itt 和 npx skills remove intent-cli -g。IntHub 令牌在过期前一直有效,可以在设置里作废。

文档

贡献指南 · 行为准则 · 安全策略 · MIT 许可