gastown/gtGas Town 多智能体工作区管理器的 npm 安装与使用指南【免费下载链接】gastownGas Town - multi-agent workspace manager项目地址: https://gitcode.com/GitHub_Trending/ga/gastown导读gastown/gt是 Gas Town一个用于协调 AI 编码智能体的多智能体工作区管理器的官方 npm 发行包通过npm install -g gastown/gt即可在 macOS、Linux 与 Windows 上安装原生的gt命令行工具。本文以 npm-package/README.md 为主体结合 npm-package/package.json、postinstall.js、test.js 以及internal/cmd下的命令源码完整讲解包的安装机制、平台支持矩阵、二进制下载原理、核心命令用法与手动安装/故障排查方案读完即可在本地完成安装并初始化第一个 Gas Town rig。包概览npm 只是分发层真正执行的是 Go 原生二进制gastown/gt本质上是一个引导bootstrap型 npm 包它本身不含 CLI 逻辑而是在安装阶段从项目 Releases 下载与当前平台匹配的原生二进制再通过bin字段暴露gt命令。这一点在 npm-package/package.json 中体现得很明确namegastown/gtscoped 包名避免与同名包冲突version1.2.1与 Go 侧 CLI 版本保持一致见 internal/cmd/version.go 中Version 1.2.1main/binbin/gt.js是命令入口npm install -g后 npm 会为gt命令创建全局符号链接指向该 JS 包装脚本scripts.postinstallnode scripts/postinstall.jsnpm 安装完成后自动触发二进制下载enginesnode 14.0.0对 Node.js 运行时版本的最低要求os/cpu分别限定为darwin/linux/win32与x64/arm64npm 会据此做安装前置校验files发布到 npm registry 时仅包含bin/、scripts/、README.md、LICENSE体积精简。该包在 npm 侧的定位是多智能体 / 工作区管理器 / AI Agent 编排工具keywords字段multi-agent、workspace-manager、ai-agent、coding-agent、claude、git、orchestration也印证了它服务于 AI 编码智能体协调场景。安装一条命令搞定平台二进制原文档给出的标准安装方式为npm install -g gastown/gt-g表示全局安装安装后gt命令即进入PATH。文档特别强调This will download the appropriate native binary for your platform during installation安装过程中会下载与你的平台匹配的原生二进制这正是postinstall钩子承担的工作。postinstall 下载流程拆解npm-package/scripts/postinstall.js 是安装的核心其执行链路如下读取版本require(../package.json)获取version1.2.1用它拼出对应版本的 Release 归档名平台/架构映射getPlatformInfo把 Node.js 的os.platform()/os.arch()映射为发布命名darwin→darwin二进制名gtlinux→linux二进制名gtwin32→windows二进制名gt.exeWindows 需要.exe后缀其余平台直接抛错Unsupported platformx64→amd64arm64→arm64其余架构抛错Unsupported architecture。拼装归档名并下载归档命名规则为gastown_version_platform_arch.ext其中 Windows 使用zip其余平台使用tar.gz下载地址指向项目的 GitHub Releases 页面https://github.com/.../releases/download/vversion/archiveName格式。下载器对 301/302 重定向做了处理downloadFile中会递归跟进response.headers.location非 200 响应会被清理并报错解压Unix 系使用tar -xzfextractTarGzWindows 使用powershell -command Expand-Archive ...extractZip解压后校验二进制存在并在非 Windows 平台执行chmodSync(binary, 0o755)赋予可执行权限清理与验证删除下载的归档文件随后执行binary version验证二进制可运行验证失败只打印警告不中断安装CI 环境跳过脚本末尾if (!process.env.CI) { install(); }—— 在 CI 环境中跳过二进制下载避免重复拉取大文件这属于有意的设计而非缺陷。安装失败的兜底如果下载阶段出错脚本会打印可读的失败原因并提示两条路径从项目 Releases 页面手动下载二进制或在项目 issues 区提交问题随后process.exit(1)让 npm 感知安装失败。支持平台矩阵原文档明确列出支持范围结合postinstall.js与package.json的os/cpu字段可得到完整的矩阵操作系统架构归档格式二进制名macOSIntelx64 → amd64tar.gzgtmacOSApple Siliconarm64tar.gzgtLinuxx64 → amd64tar.gzgtLinuxARM64tar.gzgtWindowsx64zipgt.exe需要说明的是该矩阵对应的是 npm 包的自动下载分支package.json的cpu字段仅声明了x64与arm64因此在 npm 层面如 x86 的 32 位系统等其余架构将无法通过本包安装。除 npm 途径外仍可通过 Releases 手动下载见下文手动安装。安装后的自检scripts/test.js安装完成后可用 npm-package/scripts/test.js 做冒烟验证npm test。该脚本用最朴素的方式做了三项检查二进制存在bin/gtWindows 为bin/gt.exe必须存在可执行且能输出版本执行binary version输出必须包含gt version字样以此证明二进制可运行且版本信息正常包装脚本存在bin/gt.js必须存在。最终打印N passed, N failed任一失败即以非零码退出。这套自检与postinstall.js末尾的版本验证形成双重保障可用于确认安装完整性。核心命令用法与底层实现原文档给出的四个入门命令如下# 检查版本 gt version # 初始化一个新的 town gt init # 查看状态 gt status # 列出 rigs gt rig list下面结合源码逐一展开。gt version版本与构建信息命令实现在 internal/cmd/version.go。默认输出gt version Version (Build: branchcommit)格式其中Version/Build/Commit/Branch是编译期通过 ldflags 注入的变量未注入时为dev未注入时通过debug.ReadBuildInfo()读取 Go 模块构建信息中的vcs.revision与vcs.branch仍取不到分支时退化为运行时执行git symbolic-ref --short HEAD。两个可选 flag 进一步丰富了输出gt version # 默认格式 gt version --short # 仅输出 1.2.1-dev 形式的版本号 gt version -v # 追加 Timestamp 与 Go 版本verbose其中--short便于脚本解析版本号--verbose便于排查构建时间戳与运行时环境。gt init把当前目录初始化为一个 rig命令实现在 internal/cmd/init.go其职责与约束如下前置条件当前目录必须是 git 仓库内部调用git.NewGit(cwd).CurrentBranch()否则报错not a git repository (run git init first)幂等保护若已存在polecats/目录且未加--force报错rig already initialized (use --force to reinitialize)-f/--force用于重新初始化既有结构创建标准代理目录遍历rig.AgentDirs创建polecats/、witness/、refinery/、mayor/等目录并为每个目录写入.gitkeep更新 .git/info/exclude把代理目录以/polecats/这种仓库根锚定形式追加到.git/info/exclude源码注释特别说明锚定根路径是为了避免refinery/这类模式在任意深度匹配、误伤internal/refinery/之类的源码目录注册 beads 自定义类型若检测到bd命令与.beads目录则以最佳努力方式写入types.custom、types.infra配置beads 未安装或数据库未初始化时静默跳过自动配置 Dolt 生命周期通过daemon.EnsureLifecycleConfigFile在mayor/daemon.json中补全 reaper、compactor、doctor、backup 等维护 patrol 的默认配置只补缺失项不覆盖已有用户配置。初始化完成后命令会提示两个下一步gt rig add name git-url把该 rig 加入某个 town以及gt polecat identity add rig name创建 polecat 身份。gt status查看 town 整体状态命令实现在 internal/cmd/status.go它会聚合展示整个 town 的运行状态包括守护进程daemondaemon.IsRunning(townRoot)检测输出 PIDDolt 服务doltserver.IsRunning检测未运行时给出提示tmux 服务通过会话列表判断是否运行ACP 服务存在时输出 PID各 rig 的智能体运行时witness、refinery、crew、polecats 等角色的运行状态以及从实际进程树中探测出的 runtime/model 信息detectRuntimeFromSession/parseRuntimeInfo解析进程 cmdline 得出例如claude/opus之类同时支持--json输出TownStatus结构体含json标签便于脚本消费。也就是说gt status是把 town 下所有服务与智能体一屏看全的入口配合gt rig list可从 town 级下沉到 rig 级。gt rig list列出 town 中的 rigsrig是 internal/cmd/rig.go 中定义的命令族Use: rigGroupID 为 GroupWorkspacerig list是其子命令Use: list用于列出 town 中注册的所有 rig每个 rig 展示名称与运行状态OPERATIONAL / PARKED / DOCKEDWitness 状态running/stoppedRefinery 状态running/stoppedpolecats 数量与 crew 成员数量。支持gt rig list --json输出 JSON 便于脚本化。同族的常用命令还有gt rig add name git-url克隆仓库并创建 rig 容器含refinery/rig/、mayor/rig/、crew/、witness/、polecats/、.beads/等结构支持--adopt接管既有目录与 fork 模式与gt rig remove name仅注销注册项不删除磁盘文件。更完整的 rig 管理流程可参考 docs/guides/fork-rig-setup.md。手动安装与故障排查原文档说明当 npm 安装失败网络受限、Release 下载被拦截、或平台不在自动下载矩阵内时可从项目的 GitHub Releases 页面直接下载与平台/架构匹配的归档解压后把二进制放入PATH即可。归档命名规则与postinstall.js完全一致gastown_版本_平台_架构.tar.gzWindows 为.zip例如gastown_1.2.1_darwin_arm64.tar.gz。常见的安装失败场景与对应处理现象可能原因处理方式Unsupported platform/architecture报错平台/架构不在支持矩阵内改用 Releases 手动下载下载超时或 HTTP 非 200网络受限或版本归档不存在重试、检查代理或手动下载安装成功但gt无法执行二进制权限丢失Unix 下执行chmod 755修复CI 中未下载二进制CI环境变量被设置设计行为在 CI 中显式运行node scripts/postinstall.jsgt version输出为空二进制与系统不匹配删除bin/后重装或用 Releases 对应归档覆盖Licensegastown/gt以 MIT 协议开源见 npm-package/LICENSEpackage.json的license字段亦标注为MIT可自由使用与二次分发商用场景下注意保留版权声明即可。小结gastown/gt用最轻量的 npm 包装解决了跨平台分发 Go 二进制的经典问题npm 负责命令入口与依赖约束postinstall.js负责平台感知的下载/解压/授权test.js负责安装自检。安装完成后gt version、gt init、gt status、gt rig list四个命令即可串起安装 → 初始化 rig → 加入 town → 查看全局状态的完整入门链路为后续使用 polecat、witness、refinery 等 Gas Town 多智能体编排能力打下基础。【免费下载链接】gastownGas Town - multi-agent workspace manager项目地址: https://gitcode.com/GitHub_Trending/ga/gastown创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考