Railway CLI

The Railway CLI lets you interact with your Railway projects from the command line. Read the CLI documentation.

Installation

Install the Railway CLI with agent support configured in one step (macOS, Linux, Windows via WSL):

bash <(curl -fsSL railway.com/install.sh) --agents -y

This installs the CLI to ~/.railway/bin and runs railway setup agent to configure detected agent tools.

To install the CLI without agent configuration:

bash <(curl -fsSL railway.com/install.sh) -y

Uninstall the CLI:

bash <(curl -fsSL cli.new) -r

Other installation methods are available in the CLI documentation: Homebrew, npm, Scoop, pre-built binaries, and source builds.

Authentication

Before using the CLI, authenticate with your Railway account:

railway login

For environments without a browser, such as SSH sessions, use browserless login:

railway login --browserless

Tokens

For CI/CD pipelines, set environment variables instead of using interactive login:

• Project token: Set RAILWAY_TOKEN for project-level actions.
• Account or workspace token: Set RAILWAY_API_TOKEN for account-level or workspace-level actions.

RAILWAY_TOKEN=xxx railway up

See Tokens for more information.

Agent Setup

Configure Railway agent support for AI coding tools:

railway setup agent -y

This installs Railway skills and configures the remote Railway MCP server (mcp.railway.com via railway mcp proxy, authenticated with your CLI login) for detected tools such as Claude Code, Cursor, Codex, OpenCode, GitHub Copilot, and Factory Droid.

Use the focused commands when you only need one part of the setup:

railway mcp install --agent cursor
railway skills --agent claude-code

Opt into the local GraphQL-backed MCP server instead:

railway setup agent -y --local
# or
railway mcp install --local --agent cursor

Contributing

See CONTRIBUTING.md for information on setting up this repository locally.

Feedback

Share feedback and suggestions on Central Station.