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

CRITICAL: Always provide ALL required flags.

When flags are missing, Railway prompts interactively. With all required flags, it's fully non-interactive.

# CORRECT - Non-interactive
railway link --project <project-id> --environment <env> [--service <service>] --json

# WRONG - Will block waiting for input
railway link
railway link --project my-project  # Missing --environment

**After switching, use status skill to verify the link.

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

Examples

Rename project:

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

Enable PR deploys:

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

Make project public:

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

Multiple fields:

scripts/railway-api.sh '<mutation>' '{"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.