railway-projects

List, switch, and configure Railway projects via the Railway CLI and GraphQL API.

30.5k|3.5k|Updated Jul 4, 2025
One-click install
npx skills add https://github.com/davila7/claude-code-templates --skill railway-projects
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: railway-projects
Source: https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/railway/projects
Command: npx skills add https://github.com/davila7/claude-code-templates --skill railway-projects

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires railway-cli.

What problem does it solve?

Managing multiple Railway projects across workspaces requires memorizing CLI commands and GraphQL mutations; this Skill streamlines listing, switching, and updating project settings from natural language requests.

Core Features & Use Cases

  • Project Discovery: List all projects and workspaces with simplified JSON summaries using railway list and railway whoami.
  • Project Switching: Link a different project to the current directory with railway link by ID, name, or interactive selection.
  • Settings Management: Rename projects, toggle PR deploys, and control public/private visibility through the Railway GraphQL API.
  • Use Case: Ask to enable PR deploys on your staging project, and the Skill retrieves the project ID and executes the correct projectUpdate mutation automatically.

Quick Start

Ask the assistant to list all your Railway projects and enable PR deploys on the one named staging.

Frequently Asked Questions about railway-projects

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I list all my Railway projects from the CLI?

Run `railway list --json` to get all projects across workspaces. The output can be large, so extract only essential fields like project id, name, and workspace name for a readable summary.

How do I switch to a different Railway project?

Use `railway link -p <project-id-or-name>` to link a specific project to the current directory, or run `railway link` without arguments for an interactive picker. Run `railway status` afterward to confirm the switch.

How do I enable PR deploys on a Railway project?

Get the project ID from `railway status --json`, then call the projectUpdate GraphQL mutation with the input field `prDeploys` set to true. The railway-api.sh helper script executes the mutation against the Railway API.

Can I make a Railway project public or private from the CLI?

Yes, use the projectUpdate GraphQL mutation with the `isPublic` boolean field in the ProjectUpdateInput. Set it to true to make the project public or false to make it private.

Why does Railway say project not found when I try to switch?

The project name or ID does not match any project in your workspaces. Run `railway list` to see available projects and verify the exact name or ID before linking.

What permissions are needed to update Railway project settings?

You must be authenticated with `railway login` and have a role with modification rights on the project. Permission denied errors indicate your Railway role lacks access to that project.