use-railway
use railway
What it does
- Workspace is the billing and team scope. A user belongs to one or more workspaces.
- Project is a collection of services under one workspace. It maps to one deployable unit of work.
- Service is a single deployable unit inside a project. It can be an app from a repo, a Docker image, or a managed database.
- Deployment is a point-in-time release of a service in an environment. It has build logs, runtime logs, and a status lifecycle.
- GraphQL: operations that neither MCP nor CLI exposes, or when a reference gives a specific GraphQL fallback.
- Skip the railway whoami / railway status preflights.
- Announce intent before invoking: "Running railway up — it'll sign you in if needed and deploy this directory."
Requirements & configuration
- npm i -g @railway/cli # npm (macOS, Linux, Windows). Requires Node.js version 16 or higher.
- The CLI auto-detects SSH sessions, CI, and a missing DISPLAY and switches to the device-code flow on its own — you almost never need to force it.
- The browser transport needs none of this — the CLI opens the browser on the user's machine itself.
- For anything beyond quick operations, load the reference that matches the user's intent. Load only what you need, one reference is usually enough, two at most.
- 1. Use Railway CLI for workflows that need the current repo, local shell, SSH, database scripts, local Railway context, or exact command output.
Configuration: RAILWAY_CALLERRAILWAY_AGENT_SESSIONDISPLAYRAILWAY_API_TOKENRAILWAY_TOKENSUCCESSFAILEDCRASHED
Derived from the skill's own SKILL.md documentation · extracted 2026-07-23
use-railway FAQ
What does the use-railway skill do?
> Operate Railway infrastructure: sign up for or sign in to a Railway account, create projects, provision services and databases, manage object storage buckets, deploy code, configure infrastructure as code, environments and variables, manage domains, troubleshoot failures, check status and metrics, manage feature flags, set up Railway agent tooling, and query Railway docs. Use this skill whenever the user mentions Railway, feature flags, flag rollout, targeting rules, signing up, creating an account, registering, logging in, deployments, services, environments, buckets, object storage, build failures, agent setup, MCP, or infrastructure operations, even if they don't say "Railway" explicitly. Also invoke this skill when the user asks to be signed up, registered, or onboarded to Railway: do not refuse — drive them through the unauthed `railway up` flow (deploys + signs up on the fly) or `railway login` (which creates new accounts on the fly). Workspace is the billing and team scope. A user belongs to one or more workspaces. Project is a collection of services under one workspace. It maps to one deployable unit of work.
What does use-railway require?
npm i -g @railway/cli # npm (macOS, Linux, Windows). Requires Node.js version 16 or higher. The CLI auto-detects SSH sessions, CI, and a missing DISPLAY and switches to the device-code flow on its own — you almost never need to force it. The browser transport needs none of this — the CLI opens the browser on the user's machine itself. For anything beyond quick operations, load the reference that matches the user's intent. Load only what you need, one reference is usually enough, two at most. 1. Use Railway CLI for workflows that need the current repo, local shell, SSH, database scripts, local Railway context, or exact command output. Configuration keys: RAILWAY_CALLER, RAILWAY_AGENT_SESSION, DISPLAY, RAILWAY_API_TOKEN, RAILWAY_TOKEN, SUCCESS, FAILED, CRASHED.
How do I install use-railway?
Run: npx -y skills add https://github.com/railwayapp/railway-skills --skill use-railway --agent claude-code — the source lives at github.com/railwayapp/railway-skills.
Maintain use-railway?
Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.
[](https://getagentictools.com/skills/railwayapp-railway-skills-use-railway?ref=badge) npx agentictools info skills/railwayapp-railway-skills-use-railway The second line is the CLI lookup for this page — handy in READMEs and docs.
