Railway Project Management

SkillCloud & infra

railway-projects is a skill that lets an AI agent list, switch, and configure Railway projects. It covers everyday project management tasks such as renaming a project, toggling PR deploys, changing visibility, and modifying project settings, so these changes can be made through the agent instead of by hand.

Use Railway Project Management in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Railway Project Management and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use the Railway Project Management skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Have access to your Railway account and projects.

Railway Project ManagementStart free

What your AI can do with it

  • List all Railway projects
  • Switch between Railway projects
  • Rename a project
  • Enable or disable PR deploys
  • Make a project public or private
  • Modify project settings

Getting started

  1. Have access to your Railway account and projects.
  2. Add the railway-projects skill to your agent's available skills.
  3. Ask the agent to list your projects, switch projects, or change settings such as PR deploys or visibility.

What this skill tells your AI

The instructions your AI receives, as published by davila7/claude-code-templates in cli-tool/components/skills/railway/projects/SKILL.md and read by ahel’s review.

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

FieldTypeDescription
nameStringProject name
descriptionStringProject description
isPublicBooleanMake project public/private
prDeploysBooleanEnable/disable PR deploys
botPrEnvironmentsBooleanEnable 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.

Signals

GitHub stars
32k
Forks
4k
Last commit
Oct 2026

Questions

When should this skill be used?
When you want to list all projects, switch projects, rename a project, enable or disable PR deploys, make a project public or private, or modify project settings.
Can it change project visibility?
Yes, it can make a project public or private.
Does it deploy code?
It can enable or disable PR deploys on a project, but the item does not describe triggering deployments itself.
Advanced
Item type
skill
Key
railway-projects
Source
github.com/davila7/claude-code-templates