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.

CRITICAL: Agents must provide ALL required flags for non-interactive use:

# CORRECT - Non-interactive
railway link --project <id-or-name> --environment <env> --json

# WRONG - Will block waiting for input
railway link

To create a new project: railway init

Or for linking:

railway link --project <id-or-name> --environment <env> [--service <service>] --json

NEVER run: railway link (missing required flags)

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