aihub 使用指南

普通 Forgejo 让代码跨设备同步；aihub 让 AI 开发的上下文也跨设备同步——换台机器、起个新的 Claude Code 会话，带着上次的进度与「下一步」接着干。

📦 照常用 Git

代码、commit、PR、issue 全在 Forgejo：https://git.blk.so

🤖 多一层 AI 上下文

每次提交自动捕获本次 AI 会话（进度 / 改动 / 下一步）进平台 Store。

🔁 带记忆的 resume

aihub resume 起的新会话直接「知道」上次做到哪。

🧭 仓库内可见

每个仓库页多一个「AI 会话」tab，点进来看历史与 resume.md。

安装 aihub

开发机需要：Go 1.22+ 构建（或拿现成二进制）、entire CLI、已登录的 Claude Code。

# 1) 安装 entire（AI 会话捕获）
curl -fsSL https://entire.io/install.sh | bash

# 2) 安装 aihub CLI —— 从源码构建单二进制
git clone https://git.blk.so/aihub/aihub.git && cd aihub/hub
go build -o ~/.local/bin/aihub ./cmd/aihub
aihub --help

指向这台部署好的平台：

export AIHUB_HUB=https://git.blk.so:8443
export AIHUB_TOKEN=<平台管理员提供的 HUB_TOKEN>

怎么用（3 步）

设备 A：装一次自动同步钩子，然后照常开发

cd my-project
aihub autosync --repo-dir . --repo my-project   # 装一次
# …用 Claude Code 写代码，git commit / push…
# 每次 commit 自动把这次 AI 会话捕获进平台（你什么都不用做）

设备 B：拿代码 + 上次上下文

aihub clone https://git.blk.so/aihub/my-project.git --repo my-project --dir my-project
cat my-project/.aihub/resume.md     # 平台自动生成的「上次工作记录」

设备 B：起带记忆的新会话，接着干

cd my-project
aihub resume --agent claude-code    # 新 Claude 会话带着上次上下文继续

现在就能体验

接力（同 agent 跨会话）：todo-api —— 会话A 搭骨架留 TODO → 会话B 实现+测试。看接力时间线 →
并行（多 agent / 多 git 用户）：parallel-api —— alice 与 bob 在两条分支并行开发、改到同一文件。看 Agent 泳道 →

两个视图可在仓库页顶部「接力时间线 ↔ 并行协作」切换。

它和普通 Forgejo 的关系

aihub 不改 Forgejo。Forgejo 原样在底下管代码（藏在 GitBackend 接口后，将来可换 GitHub/GitLab）；aihub 只是在它之上加了「会话捕获 + Store + resume」这一层。不用 AI 写代码时，体验与普通 Forgejo 完全一致。