Agent Session

Agent Session 是会话的云端归档与共享层。上传后的 session 可以：在 Multica issue 里被自动关联和读取、在网页上按文件夹浏览、跨机器恢复续跑、按链接分享给同事。上传永远是显式动作，不会自动发生。

上传

会话内（最常用）

Claude Code 会话里输入：

/upload

Codex 会话里输入（$up 可补全）：

$upload

上传当前会话，默认私有。可带元数据：--title 设标题、--public 共享给组织、--issue <url> 挂到 Multica issue。

CLI

指定会话上传，首选 --path 直接给绝对路径（不用翻找 provider + UUID）：

ginit context upload --provider codex --path /root/.codex/sessions/2026/09/12/rollout-9f1c.jsonl --title "发布流水线排查"

ginit context upload --provider claude_code --path ~/.claude/projects/-root-src-homepage/abc123.jsonl

也可以按 provider:session-id 定位（适合已经拿到 session id 的场景）：

ginit context upload codex:9f1c2a4b-...

批量与当前会话：

ginit context upload-many claude_code:abc123 claude_code:def456 --continue

ginit context upload-current --title "修复登录 bug 的排查过程" --issue https://multica.ginit.opensii.ai/w/demo/i/SII-1234

upload-current 自动定位当前工作目录的活跃会话；upload-many 批量、--continue 失败继续。都支持 --title / --folder-id / --public / --issue 元数据。

issue 联动：带 --issue 上传（或会话本身已绑 issue）时，上传完成后 session 会自动挂进该 Multica issue 的 Agent Session 上下文，看板里直接可读。

文件夹

ginit context folder create "本周排查记录"

ginit context folder list

上传时 --folder-id 归档到指定文件夹。

浏览与组织共享

• 网页端：session.opensii.ai——session 列表、详情、按轮次展开阅读
• 可见性：默认私有；--public 共享给组织，组织共享文件夹里的 session 全员可读
• 分享：每个 session 有稳定链接；别人拿到链接即可用下面的 read 命令读取（按 Drive ACL 控权）

读取与恢复

读别人分享的 session：

ginit agent session read https://session.opensii.ai/s/<node-id>

跨机器恢复续跑（下载 provider 原生 JSONL 放回本机，交给 Claude/Codex 原生 resume）：

ginit context resume claude_code <session-id> --cwd /path/to/project

目录绑定（会话与工作目录配对，恢复时自动进目录）：

ginit agent session bind-dir <session-id> --dir /path/to/project

ginit agent session attach-dir <session-id>

常见问题

session 会自动上传吗？ 不会。没有任何 hook 或后台进程替你上传，每次上传都是你（或你在会话里让 agent 执行 /upload）发起的显式动作。

上传的东西去哪了？ 会话 JSONL 归档在云端（ginit-server 管理的对象存储），标题/文件夹/可见性等元数据在服务端索引。Multica 通过桥接只读这些元数据与轮次内容。

误传了敏感内容？ 私有 session 只有你可见；需要删除或改名：ginit agent session rename <session-id> <new-title>，删除请联系平台。