快速开始

这一页给出一条最短路径,让你从零开始跑通一个 repostack stack。

1. 初始化工作目录

repostack init

执行后会在当前目录生成 repostack.yaml

2. 把一个本地 repo 纳入 stack

假设当前目录下已经有 foo/

repostack use foo

这会把 foo 写入 repostack.yamlrepos 列表中。

3. 查看当前 stack 状态

repostack list

输出会展示每个 repo 的:

  • 名称
  • 当前 branch
  • 当前 revision
  • 是否 dirty

4. 定义脚本并执行

repostack.yaml 中添加 scripts

scripts:
  test:
    command: pnpm test             # 无范围:在 stack root 执行一次
  typecheck:
    command: pnpm typecheck
    views: [runtime]               # 在 runtime view 下的每个 repo 中执行

然后执行:

repostack run test
repostack run typecheck

5. 生成快照

repostack snapshot

这会把当前 stack 中每个 repo 的 Git 状态写入 repostack.lock.yaml

6. 调试编排过程

如果要看命令解析、repo 选择和实际执行细节:

repostack --debug run test

调试信息会写到 stderr,业务输出仍然写到 stdout