railway-projects
List, switch, and configure Railway projects. Use when user wants to list all projects, switch projects, rename a project, enable/disable PR deploys, make a project public/private, or modify project settings.
When & Why to Use This Skill
The railway-projects skill empowers users to manage their Railway cloud infrastructure seamlessly through Claude. It provides comprehensive tools to list, switch, and configure projects and workspaces, enabling efficient DevOps workflows and infrastructure-as-code style adjustments directly via natural language or CLI-integrated commands.
Use Cases
- Case 1: Multi-project management where a user needs to quickly list all active projects and switch the current context to a specific workspace for deployment.
- Case 2: Automating project settings updates, such as renaming a project or toggling 'PR Deploys' to streamline CI/CD pipelines during development cycles.
- Case 3: Infrastructure security and visibility control, allowing users to instantly make a project public or private based on deployment requirements.
- Case 4: Workspace auditing where a user needs to retrieve a simplified summary of project IDs and associated services to maintain an overview of their cloud resources.
| name | railway-projects |
|---|---|
| description | List, switch, and configure Railway projects. Use when user wants to list all projects, switch projects, rename a project, enable/disable PR deploys, make a project public/private, or modify project settings. |
| version | 1.0.0 |
| author | Railway |
| license | MIT |
| tags | [Railway, Projects, Workspace, Management, Settings, Infrastructure] |
| dependencies | [railway-cli] |
| allowed-tools | Bash(railway:*) |
Railway 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 <project-id-or-name>
Or interactively:
railway link
After switching, use railway-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'
${CLAUDE_PLUGIN_ROOT}/skills/lib/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:
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"name": "new-name"}}'
Enable PR deploys:
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"prDeploys": true}}'
Make project public:
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"isPublic": true}}'
Multiple fields:
${CLAUDE_PLUGIN_ROOT}/skills/lib/railway-api.sh '<mutation>' '{"id": "uuid", "input": {"name": "new-name", "prDeploys": true}}'
Composability
- View project details: Use railway-status skill
- Create new project: Use railway-new skill
- Manage environments: Use railway-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.