让开源，少一点语言距离。
npm包中文文档

@cprecioso/paseo-gh-stack

中文文档
0.2.2发布于 2026/10/09MIT零依赖构建来源已验证近 30 天下载 2063

Paseo workspace panel for GitHub stacked PRs: see the gh stack your branch belongs to and switch the workspace between its branches.

原始使用文档
中文原文
文档目录5 节
  1. Features
  2. Requirements
  3. Install
  4. Limitations
  5. License

paseo-gh-stack

A Paseo plugin for GitHub stacked PRs. It shows the gh stack the workspace's branch belongs to and switches the workspace between the branches in it.

The Stack panel next to an agent, listing three stacked branches with their PR numbers above the trunk

Features

  • Stack panel: a workspace tab (also available in the Explorer) listing the stack from top to trunk. Each branch shows its PR number, and whether it is merged, queued, or needs a rebase. Tap a branch to check it out in the workspace.
  • Stacks on GitHub: when the branch isn't tracked by gh stack locally, the panel looks up its pull request in GitHub's stacks and offers a Check out stack button that runs gh stack checkout <number>.
  • Command Center (⌘K / Ctrl+K):
    • Open stack
    • Stack: check out branch above
    • Stack: check out branch below

The panel refreshes every 15 seconds, so branch changes made from a terminal or by an agent show up on their own.

Requirements

On the daemon host:

  • The GitHub CLI (gh)
  • The gh-stack extension: gh extension install github/gh-stack

Install

Requires Paseo 0.10.3 or later.

paseo plugin install npm:@cprecioso/paseo-gh-stack

Or from GitHub:

paseo plugin install github:cprecioso/paseo-gh-stack

Then open the panel from a workspace's new-tab menu, or run Open stack from the Command Center.

Limitations

  • Switching runs git switch <branch> in the workspace directory. Git refuses when uncommitted changes would be overwritten, or when the branch is already checked out in another worktree; the error is shown as a toast.
  • Switching branches changes the files under any agent running in the workspace. The panel warns you when an agent is running.
  • Stacks found on GitHub are only detected when the current branch has a pull request and the stack still has unmerged PRs.
  • Checking out a GitHub stack fails without prompting when it conflicts with a local stack; resolve it with gh stack checkout in a terminal.

License

MIT

版本与发布记录

@cprecioso/paseo-gh-stack 共发布 5 个版本，首次发布于 2026/10/08；过去 12 个月发布了 5 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.2latest2026/10/091 个月前
0.2.12026/10/081 个月前
0.2.02026/10/081 个月前
0.1.02026/10/081 个月前
0.0.0-stage2026/10/081 个月前

关于 @cprecioso/paseo-gh-stack 的常见问题

@cprecioso/paseo-gh-stack 是什么？

Paseo workspace panel for GitHub stacked PRs: see the gh stack your branch belongs to and switch the workspace between its branches.

如何安装 @cprecioso/paseo-gh-stack？

在项目目录运行 npm install @cprecioso/paseo-gh-stack，或使用 pnpm add / yarn add / bun add。

@cprecioso/paseo-gh-stack 支持 TypeScript 吗？

该包的 package.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/cprecioso__paseo-gh-stack 是否存在。

@cprecioso/paseo-gh-stack 可以商用吗？

@cprecioso/paseo-gh-stack 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

@cprecioso/paseo-gh-stack 的下载量有多少？

根据 npm 官方下载统计，@cprecioso/paseo-gh-stack 在 2026/10/11 – 2026/11/09 这 30 天内被下载 2,063 次，日均约 69 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@cprecioso/paseo-gh-stack 还在维护吗？

最新版本 0.2.2 发布于 2026/10/09（1 个月前）；至今共发布 5 个版本，其中过去 12 个月发布了 5 个；首次发布于 2026/10/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。