projects

项目管理

列出、切换和配置 Railway 项目。

使用场景

• 用户询问“列出我的所有项目”或“我有哪些项目”
• 用户询问不同工作区中的项目
• 用户询问“我有哪些工作区”
• 用户想切换到其他项目
• 用户询问如何重命名项目
• 用户想启用或禁用 PR 部署
• 用户想将项目设为公开或私有
• 用户询问项目设置

列出项目

railway list --json 的输出可能非常庞大。请在子 Agent 中运行，只返回必要字段：

• 项目：id、name
• 工作区：id、name
• 服务：name（可选，用户需要服务相关信息时提供）

railway list --json

提取并返回简化摘要，而不是完整的 JSON。

列出工作区

railway whoami --json

返回用户信息，包括该用户所属的所有工作区。

切换项目

将其他项目关联到当前目录：

railway link -p <project-id-or-name>

也可以通过交互方式操作：

railway link

切换后，使用 status 技能查看项目详情。

更新项目

通过 GraphQL API 修改项目设置。

获取项目 ID

railway status --json

从响应中提取 project.id。

更新 Mutation

bash <<'SCRIPT'
scripts/railway-api.sh \
  'mutation updateProject($id: String!, $input: ProjectUpdateInput!) {
    projectUpdate(id: $id, input: $input) { name prDeploys isPublic botPrEnvironments }
  }' \
  '{"id": "PROJECT_ID", "input": {"name": "new-name"}}'
SCRIPT

ProjectUpdateInput 字段

字段	类型	描述
name	String	项目名称
description	String	项目描述
isPublic	Boolean	将项目设为公开或私有
prDeploys	Boolean	启用或禁用 PR 部署
botPrEnvironments	Boolean	启用 Dependabot/Renovate PR 环境

示例

重命名项目：

scripts/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"name": "new-name"}}'

启用 PR 部署：

scripts/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"prDeploys": true}}'

将项目设为公开：

scripts/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"isPublic": true}}'

多个字段：

scripts/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"name": "new-name", "prDeploys": true}}'

组合使用

• 查看项目详情：使用 status 技能
• 创建新项目：使用 new 技能
• 管理环境：使用 environment 技能

错误处理

未通过身份验证

Not authenticated. Run `railway login` first.

没有项目

No projects found. Create one with `railway init`.

权限被拒绝

You don't have permission to modify this project. Check your Railway role.

未找到项目

Project "foo" not found. Run `railway list` to see available projects.