PluginInstalls cleanly
Put your app online with Railway
Railway plugin (railway-skills)
Railway's official plugin lets your assistant create a project, deploy your app, add a database and read logs on Railway, with a sign-in in the browser.
- Works with
- Claude Code
- Good for
- Build an app
What it does
Railway is a hosting service. It runs your website, app or database on its servers so other people can use it. This is Railway's own plugin for Claude Code, version 1.7.0. It lets your assistant set up a Railway project, deploy the code in your folder, add a database, set variables and read the logs when something breaks.
Read this first. The plugin has a hook (a small script that runs automatically). It runs before every shell command. When a command is one single command that starts with railway, the hook approves it, so Claude Code does not ask you. The hook does not look at what the command does. That includes:
railway delete --yes, which deletes a project for good.railway run, which starts any program on your computer with your service's variables.railway ssh, which opens a shell on your running service.railway api, which can send any change to your Railway account.railway up -y, which deploys the folder you are in.
Only commands that chain several steps still get the normal prompt. The skill tells the assistant to confirm before it deletes things, but the hook does not enforce that. Read each railway command before the assistant runs it. If you want Claude Code to ask every time, do not install this plugin.
The plugin has three parts:
- A connector (an MCP server, a bridge to another service) at
mcp.railway.com. It signs in to your Railway account in the browser. During sign-in you choose which workspaces and projects it can reach. It can create projects, start deploys, change feature flags and pass your requests to Railway's own AI agent. - One large skill (an instruction file) called use-railway. It tells the assistant which Railway tool to use for each job.
- The hook described above.
Some jobs, such as deploying the folder you are in or checking a database, need the Railway CLI, a small program you install once. When you ask to deploy, the skill runs railway up itself. If the folder has no linked project, it creates a new Railway project and deploys the folder. While the skill is active, it also pre-approves curl, npm, npx and python3 commands.
The Railway CLI sends usage data to Railway, such as command names, how long they took and error text. The skill also tags each call with a session id. To turn this off, set RAILWAY_NO_TELEMETRY=1 (Railway CLI docs).
Railway's optional installer (curl -fsSL agents.railway.com | sh) runs a script from the internet. It installs the CLI, and it also writes Railway skills and connector settings into the other coding tools it finds on your computer.
Who it is for
People who built an app with an AI assistant and want to put it online on Railway, with a database next to it.
Example prompts
- "Deploy this app to Railway."
- "Check the Railway status for this project."
- "Debug my latest failed Railway deployment."
- "Add a Postgres database to this Railway project and connect it to my app."
- "How much has this Railway project used this month?"
How to install
/plugin marketplace add railwayapp/railway-skills/plugin install railway@railway-skills/reload-pluginsHow to use it
Connect your Railway account when Claude Code asks (sign-in creates an account if you have none). Then ask: Deploy this app to Railway. Or: Debug my latest failed Railway deployment.
Check it works
- In Claude Code, run
/pluginand look for railway in the installed list. - Ask the assistant something about your Railway projects. The first time it uses a Railway tool, a browser page opens so you can connect your Railway account.
- If you installed the CLI, run
railway whoami --json. It shows the account you are signed in to (the skill's own first check).
Common problems
- Claude Code can't find the plugin — no exact error text in the README — run
/plugin marketplace update claude-plugins-official, or use the railway-skills marketplace lines above (README). - A deploy needs the CLI but it is missing — no exact error text — install it with
curl -fsSL agents.railway.com | sh, then runrailway login(plugin README). That script also changes other coding tools, as described above. - Database analysis scripts fail — no exact error text — they need python3 installed (plugin README).
- The hook approves nothing — no error text — the hook needs the jq program; without jq, Claude Code asks you about every railway command as normal (hooks/auto-approve-api.sh).
What to watch out for
- The plugin's hook runs before every shell command and lets any single command that starts with railway run without asking you, whatever it does: railway delete --yes deletes a project for good, railway run starts any program on your computer, railway ssh opens a shell on your service, railway api can send any change to your Railway account and railway up -y deploys; only commands that chain several steps still get the normal prompt (hooks/auto-approve-api.sh, Railway CLI docs)
- When you ask it to deploy, the skill runs railway up itself; with no linked project it creates a new Railway project and deploys the folder you are in (SKILL.md)
- While the skill is active it also pre-approves curl, npm, npx, python3, which and command (allowed-tools in SKILL.md)
- The Railway connection can create projects, start deploys, change feature flags and pass your requests to Railway's own AI agent; the CLI and that agent can also add databases, storage buckets and variables (Railway MCP docs)
- The skill tags Railway CLI calls with a session id, and the Railway CLI sends usage data to Railway, such as command names and error text; set RAILWAY_NO_TELEMETRY=1 to turn it off (Railway CLI docs)
- The optional installer (curl -fsSL agents.railway.com | sh) runs a script from the internet and also writes Railway skills and connector settings into the other coding tools it finds on your computer (README)
- Railway bills for usage: the Free plan has $1 of credit a month, and Hobby costs $5 a month with $5 of usage included (Railway pricing docs)
Licence and author
- Licence
- MIT
- Author
- Railway
- Source code
- github.com/railwayapp/railway-skills
How we tested it
We installed it on an empty test computer on 17 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.
Not run: "/reload-plugins" (not a form the sandbox runs). Not yet used on real work.
Technical details of the test
- Date
- 17 Oct 2026
- Method
- Intake sandbox run on 2026-10-17 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; installed railway@railway-skills with the Claude Code command line.
Checked again on 17 Oct 2026
Alternatives
- Render plugin — the same kind of help for Render hosting.
- Netlify skills — best for websites and front ends, not servers and databases.
- Lovable MCP — builds and hosts the app inside Lovable instead of your own code.
FAQ
Do I need a Railway account? Yes. The README says signing in creates one if you have none.
Does it cost money? Installing the plugin needs no payment. Railway bills for usage. The Free plan includes $1 of credit a month. Hobby costs $5 a month with $5 of usage included (Railway pricing docs).
Will it delete things without asking?
It can. The skill tells the assistant to confirm before destructive actions, but the hook approves any single railway command, including railway delete --yes. Read each command before the assistant runs it. To keep the prompts, do not install the plugin.
Is it in Anthropic's directory?
Yes, as railway@claude-plugins-official, pinned to version 1.5.2 (September 2026). The railway-skills marketplace lines above give version 1.7.0. The hook is the same in both.
Sources
- github.com/railwayapp/railway-skills
- github.com/railwayapp/railway-skills/blob/main/plugins/railway/skills/use-railway/SKILL.md
- github.com/railwayapp/railway-skills/blob/main/plugins/railway/hooks/auto-approve-api.sh
- docs.railway.com/ai/remote-mcp-server
- docs.railway.com/cli/delete
- docs.railway.com/cli/run
- docs.railway.com/cli/telemetry
- docs.railway.com/pricing/plans
- raw.githubusercontent.com/anthropics/claude-plugins-official/main/.claude-plugin/marketplace.json