# 快速开始

> 

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

## 1. 初始化工作目录

```bash
repostack init
```

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

## 2. 把一个本地 repo 纳入 stack

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

```bash
repostack use foo
```

这会把 `foo` 写入 `repostack.yaml` 的 `repos` 列表中。

## 3. 查看当前 stack 状态

```bash
repostack list
```

输出会展示每个 repo 的：

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

## 4. 在多个 repo 中执行命令

```bash
repostack run --repos foo -- pnpm test
```

如果已经定义了 view，也可以这样执行：

```bash
repostack run --view runtime -- pnpm typecheck
```

## 5. 生成快照

```bash
repostack snapshot
```

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

## 6. 调试编排过程

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

```bash
repostack --debug run --repos foo -- pnpm test
```

调试信息会写到 `stderr`，业务输出仍然写到 `stdout`。