mcpField
S
status

status

github.com/railwayappCloud & DevOps3391.5k installsUpdated 2w ago
Repository

About status

A skill for checking the Railway project linked to the current directory. It presents environment, service, deployment and domain details, including deployments in progress.

Key features

  1. 01Read project and workspace details
  2. 02List the current environment and services
  3. 03Check deployment and in-progress states
  4. 04Show configured domains

Use cases

  1. 01Confirm the linked project before Railway operations
  2. 02Check whether a service is deployed or building
  3. 03Review the current environment and active deployments
  4. 04Verify domains configured for the project

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/railwayapp/railway-skills --skill status

After installing, type/statusin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
environment-config.md
monorepo.md
railpack.md
variables.md

Details

From the project README

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.).

Comments

Markdown supported