# Railway

> Interact with Railway deployments — check status, view logs, redeploy services, and manage environment variables. Use when this capability is needed.

- Skill: `tomevault-io/railway-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/railway-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/railway-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/railway-2

---


# Railway Skill

Manage Railway deployments directly from Viber. Uses the Railway CLI (`railway`) for deployment operations.

## Installation

Install Railway CLI:

```bash
pnpm add -g @railway/cli
# or
brew install railway
```

Then authenticate:

```bash
railway login
```

Link your project (run once in the project directory):

```bash
railway link
```

## Tools

- **`railway_status`** — Get deployment status for the linked project or a specific service
- **`railway_logs`** — View recent runtime logs
- **`railway_deploy`** — Trigger a redeployment
- **`railway_deployments`** — List recent deployments with status (SUCCESS/FAILED/BUILDING)
- **`railway_build_logs`** — Fetch build logs for a specific deployment by ID (for diagnosing build failures)
- **`railway_run`** — Run any Railway CLI command directly

## Parameters

### railway_status
- `service` (optional): Service name to check (defaults to all services)
- `cwd` (optional): Working directory (if unlinked/mismatched, auto-discovery will try matching repo-related project/service contexts)

### railway_logs
- `service` (optional): Service name to get logs for
- `lines` (optional): Number of log lines (default: 50, max: 500)
- `deploymentId` (optional): Deployment ID to fetch logs for (if omitted, uses latest deployment)
- `cwd` (optional): Working directory (if unlinked/mismatched, auto-discovery will try matching repo-related project/service contexts)

### railway_deploy
- `service` (optional): Service to redeploy
- `cwd` (optional): Working directory (if unlinked/mismatched, auto-discovery will try matching repo-related project/service contexts)

### railway_deployments
- `cwd` (optional): Working directory (if unlinked/mismatched, auto-discovery will try matching repo-related project/service contexts)

### railway_build_logs
- `deploymentId` (required): Deployment ID (UUID from railway_deployments output)
- `cwd` (optional): Working directory (if unlinked/mismatched, auto-discovery will try matching repo-related project/service contexts)

### railway_run
- `command` (required): Railway CLI subcommand and arguments (e.g. `variables list`)
- `cwd` (optional): Working directory (if unlinked/mismatched, auto-discovery will try matching repo-related project/service contexts)

## Usage from Viber

Use this skill when user intent is:

- "check railway deployment"
- "show railway logs"
- "redeploy on railway"
- "check deployment status"
- "why did the deployment fail"

Examples:

```ts
railway_status({ service: "web" })
railway_logs({ service: "web", lines: 100 })
railway_deploy({ service: "web" })
railway_deployments({})
railway_build_logs({ deploymentId: "abc-123..." })
railway_run({ command: "variables list" })
```

## Auto-Discovery Behavior

When a directory is not Railway-linked or linked to the wrong project, this skill will:

1. List accessible Railway projects via `railway list --json`
2. Score candidates using repository hints (cwd name + git remote URL)
3. Iterate candidate project/service contexts and retry commands
4. Return the first successful match, including discovery metadata in the summary

This allows the agent to keep trying across org/project/service combinations instead of failing on the first context mismatch.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/dustland) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->