use-railway

Operate Railway infrastructure through CLI, MCP, and GraphQL workflows.

1|Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Chia1104/agent-air --skill use-railway-chia1104
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: use-railway
Source: https://github.com/Chia1104/agent-air/tree/main/skills/shared/use-railway
Command: npx skills add https://github.com/Chia1104/agent-air --skill use-railway-chia1104

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Managing Railway projects, services, databases, and deployments requires knowing dozens of CLI commands, MCP tools, and GraphQL queries; this Skill routes every Railway task to the right operation path with correct context resolution. ## Core Features & Use Cases - Deploy and onboard: Run railway up to sign up, create projects and services, and deploy from the current directory in one chain, including headless device-code sign-in handling. - Database analysis: Introspect PostgreSQL, MySQL, Redis, and MongoDB services over SSH with per-database metric thresholds, tuning guidance, and log analysis. - Operations and configuration: Manage environments, variables, domains, feature flags, buckets, sandboxes, usage limits, and troubleshoot build or runtime failures. - Use Case: A user pastes a Railway dashboard URL and says "analyze this database" — the Skill extracts the project, service, and environment IDs, detects the database type, runs the matching analysis script, and produces a full performance report. ## Quick Start Ask the assistant to deploy the current directory to Railway or analyze a specific Railway database service by pasting its dashboard URL.

Frequently Asked Questions about use-railway

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy an app to Railway from the command line?▼

Run `railway up` from the project directory. It authenticates you if needed, creates a project and service when none is linked, and deploys the code. Use `railway up -y` for non-interactive runs and verify the deployment reaches SUCCESS status.

How do I analyze a Railway PostgreSQL or MySQL database?▼

Provide the Railway dashboard URL or service name, and the Skill runs the matching analysis script (analyze-postgres.py, analyze-mysql.py, analyze-redis.py, or analyze-mongo.py) over SSH. It collects metrics, logs, cache ratios, and query statistics, then produces a full performance report.

Can I sign up for Railway without a browser?▼

Yes. The CLI auto-detects headless environments and switches to a device-code flow that prints a sign-in link and code. Run the command in the background and relay the link immediately, since the code expires after 10 minutes.

Railway CLI vs Railway MCP: which should I use?▼

Use the CLI for workflows needing local state like `railway up`, SSH, or database scripts. Use remote MCP (https://mcp.railway.com) for OAuth-scoped platform reads, feature flags, and simple redeploys. Use `railway api` for GraphQL operations without a dedicated tool.

Why did my Railway deployment report success but the app is down?▼

`railway up --detach` returns after upload at QUEUED status, not success. Poll `railway deployment list --json` with the same project, environment, and service scope until the deployment shows SUCCESS, and triage FAILED or CRASHED states via logs.

What are the limitations of Railway database analysis scripts?▼

Analysis requires SSH access with a key registered via `railway ssh keys add`. If introspection fails, only infrastructure metrics and logs are available, and no performance conclusions can be drawn. Metrics history is capped at 168 hours.