projects

プロジェクト管理

Railway プロジェクトの一覧表示、切り替え、設定を行います。

使用するタイミング

• ユーザーが「自分のプロジェクトをすべて表示して」や「どんなプロジェクトがありますか」と尋ねた場合
• ユーザーがワークスペースをまたいだプロジェクトについて尋ねた場合
• ユーザーが「どんなワークスペースがありますか」と尋ねた場合
• ユーザーが別のプロジェクトに切り替えたい場合
• ユーザーがプロジェクト名の変更を求めた場合
• ユーザーが PR デプロイを有効化または無効化したい場合
• ユーザーがプロジェクトを公開または非公開にしたい場合
• ユーザーがプロジェクト設定について尋ねた場合

プロジェクトの一覧表示

railway list --json の出力は非常に大きくなることがあります。サブエージェントで実行し、必要なフィールドのみを返してください。

• プロジェクト：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 を抽出します。

更新ミューテーション

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.