Project Management

List, switch, and configure Railway projects.

When to Use User asks "show me all my projects" or "what projects do I have" User asks about projects across workspaces User asks "what workspaces do I have" User wants to switch to a different project User asks to rename a project User wants to enable/disable PR deploys User wants to make a project public or private User asks about project settings List Projects

The railway list --json output can be very large. Run in a subagent and return only essential fields:

Project: id, name Workspace: id, name Services: name (optional, if user needs service context) railway list --json

Extract and return a simplified summary, not the full JSON.

List Workspaces railway whoami --json

Returns user info including all workspaces the user belongs to.

Switch Project

Link a different project to the current directory:

railway link -p

Or interactively:

railway link

After switching, use status skill to see project details.

Update Project

Modify project settings via GraphQL API.

Get Project ID railway status --json

Extract project.id from the response.

Update 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 Fields Field Type Description name String Project name description String Project description isPublic Boolean Make project public/private prDeploys Boolean Enable/disable PR deploys botPrEnvironments Boolean Enable Dependabot/Renovate PR environments Examples

Rename project:

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

Enable PR deploys:

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

Make project public:

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

Multiple fields:

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

Composability View project details: Use status skill Create new project: Use new skill Manage environments: Use environment skill Error Handling Not Authenticated Not authenticated. Run railway login first.

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

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

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

安装