PluginBench
Skill
Pass
Audit score 90

status

railwayapp/railway-skills

Check Railway project status, deployments, and services in your directory.

What is status?

Displays the current status of your Railway project, including active services, deployment state, and configured domains. Use this when you need to verify what's deployed, check if services are running, or see deployment progress.

  • Check project name and workspace
  • View current environment (production, staging, etc.)
  • List all services with their deployment status
  • Show active deployments and build progress
  • Display configured domains and URLs

How to install status

npx skills add https://github.com/railwayapp/railway-skills --skill status
Prerequisites
  • Railway CLI installed (npm install -g @railway/cli or brew install railway)
  • Authenticated to Railway (railway login)
  • Project linked to directory (railway link or railway init)
Claude Code
Cursor
Windsurf
Cline

How to use status

  1. 1.Run `railway status --json` to fetch current project status
  2. 2.Review the project name and workspace
  3. 3.Check the current environment
  4. 4.Examine services list and their deployment status
  5. 5.Look for any active deployments in progress
  6. 6.Note any configured domains and URLs

Use cases

Good for
  • Verify a deployment completed successfully before testing
  • Check if a service is running or still deploying
  • See the current state of all services in a project
  • Monitor build progress during deployment
  • Confirm project is linked before performing operations
Who it's for
  • Developers deploying to Railway
  • DevOps engineers monitoring deployments
  • Teams checking project status before changes

status FAQ

What's the difference between this skill and the environment skill?

This skill shows overall project status and deployments. Use the environment skill for detailed service configuration (builder type, start command, environment variables, etc.).

How do I know if a deployment is still in progress?

Check the activeDeployments field for each service. If it shows 'building' or 'deploying', the deployment is still running.

What if I see 'No linked project'?

Link an existing project with `railway link` or create a new one with `railway init`.

Can I use this to check environment variables?

No, use the environment skill for that. This skill only shows deployment and service status.

How do I authenticate if I'm not logged in?

Run `railway login` to authenticate with your Railway account.

Full instructions (SKILL.md)

Source of truth, from railwayapp/railway-skills.


name: status description: This skill should be used when the user asks "railway status", "is it running", "what's deployed", "deployment status", or about uptime. NOT for variables ("what variables", "env vars", "add variable") or configuration queries - use environment skill for those. allowed-tools: Bash(railway:), Bash(which:), Bash(command:*)

Railway Status

Check the current Railway project status for this directory.

When to Use

  • User asks about Railway status, project, services, or deployments
  • User mentions deploying or pushing to Railway
  • Before any Railway operation (deploy, update service, add variables)
  • User asks about environments or domains

When NOT to Use

Use the environment skill instead when user wants:

  • Detailed service configuration (builder type, dockerfile path, build command, root directory)
  • Deploy config (start command, restart policy, healthchecks, predeploy command)
  • Service source (repo, branch, image)
  • Compare service configs
  • Query or change environment variables

Check Status

Run:

railway status --json

First verify CLI is installed:

command -v railway

Handling Errors

CLI Not Installed

If command -v railway fails:

Railway CLI is not installed. Install with:

npm install -g @railway/cli

or

brew install railway

Then authenticate: railway login

Not Authenticated

If railway whoami fails:

Not logged in to Railway. Run:

railway login

No Project Linked

If status returns "No linked project":

No Railway project linked to this directory.

To link an existing project: railway link To create a new project: railway init

Presenting Status

Parse the JSON and present:

  • Project: name and workspace
  • Environment: current environment (production, staging, etc.)
  • Services: list with deployment status
  • Active Deployments: any in-progress deployments (from activeDeployments field)
  • Domains: any configured domains

Example output format:

Project: my-app (workspace: my-team)
Environment: production

Services:
- web: deployed (https://my-app.up.railway.app)
- api: deploying (build in progress)
- postgres: running

The activeDeployments array on each service shows currently running deployments with their status (building, deploying, etc.).