What is railway-logs?

A command for retrieving and examining Railway deployment logs, which are records of what an application and its services did in production. It checks the active Railway project, fetches logs for a selected service, and analyzes common error patterns.

Use it when a Railway deployment or production app is failing, optionally limiting the output to a service, number of lines, or matching pattern.

It turns raw production logs into a diagnosis of likely causes, such as an unreachable database, missing dependency, memory limit, timeout, or database-schema mismatch.

railway-logs — Skill for Claude Code by parisgroup-ai

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add parisgroup-ai/imersao-ia-setup --skill railway-logs

Clone the repo

git clone --depth 1 https://github.com/parisgroup-ai/imersao-ia-setup

Made for: Claude Code.

Or install imersao, the plugin that ships this one along with the rest of its 51 skills, 7 commands.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/parisgroup-ai/imersao-ia-setup/railway-logs/github.svg)](https://agentmods.dev/skills/parisgroup-ai/imersao-ia-setup/railway-logs)

Your own site

<a href="https://agentmods.dev/skills/parisgroup-ai/imersao-ia-setup/railway-logs"><img src="https://agentmods.dev/badge/skills/parisgroup-ai/imersao-ia-setup/railway-logs/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/parisgroup-ai/imersao-ia-setup/railway-logs"><img src="https://agentmods.dev/badge/skills/parisgroup-ai/imersao-ia-setup/railway-logs.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 60 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 421 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00060	$0.00421
Opus 5	$0.00030	$0.00211
Sonnet 5	$0.00012	$0.00084
Haiku 4.5	$0.00006	$0.00042

Measured 12d ago against content hash d84434561276, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

railway-logs scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/imersao/skills/railway-logs/SKILL.md · 42 lines

What it actually says

Railway Logs Skill

Fetch and analyze Railway production logs to diagnose deployment and runtime issues.

Usage

/railway-logs [service] [--tail N] [--filter pattern]

service: web | ana-service | api-server (default: web)
--tail N: last N lines (default: 100)
--filter pattern: grep pattern to filter output

Steps

Run railway status to confirm the active project and environment.
Run railway logs --service <service> -n <tail> to fetch logs.
If --filter was provided, pipe output through grep -i <pattern>.
Analyze the output and identify root causes.

Error Pattern Reference

Pattern	Likely Cause
`ECONNREFUSED`	Database or Redis not reachable
`Module not found`	Missing build artifact — rebuild needed
`OOM` / `out of memory`	Railway memory limit hit
`ImportError` / `ModuleNotFoundError`	ana-service Python dep missing
`ETIMEDOUT`	External API timeout (Anthropic, S3, Stripe)
`prisma` / `drizzle` error	DB schema mismatch — migration needed
`401` / `403`	Auth token expired or missing env var

After Fetching Logs

If error found: explain the root cause and suggest a fix.
If logs are clean: check the previous deployment with railway logs --deployment <id>.
For crashes: look for the last line before the restart marker.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

12d ago First seen · 42 lines · 60 tokens per session scan A d84434561276

Subscribe to this mod's changes

railway-logs is a skill published in the GitHub repository parisgroup-ai/imersao-ia-setup (1 stars, last pushed 29d ago), licensed MIT. It adds 60 tokens to every session and 421 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Claude Code Cloud Debugging DevOps and cloud ai-skills bootcamp claude-code-plugin pg-tooling

architecture-optimization

Guided journey from a working codebase grown slow and tangled to one measurably fast, cleanly bounded, and readable. Orchestrates eight skills phase by phase - working-with-legacy-code, clean-architecture, software-design-philosophy, refactoring-patterns, system-design, ddia-systems, release-it, pragmatic-programmer …

wondelai/skills · 226 tokens

remove-technical-debt

Guided journey from a large aged codebase everyone fears to touch to one that is safe to change, legible, bounded, and resilient - paid down in place without a rewrite. Orchestrates eight skills phase by phase - working-with-legacy-code, refactoring-patterns, clean-code, software-design-philosophy, clean-architecture…

wondelai/skills · 224 tokens

release-it

Build production-ready systems with stability patterns: circuit breakers, bulkheads, timeouts, and retry logic. Use when the user mentions "production outage", "circuit breaker", "deployment pipeline", "chaos engineering", "retry storm", "health checks", "my service keeps crashing", "prevent cascading failures", or…

wondelai/skills · 131 tokens

cloudflare-workers-dev-experience

Cloudflare Workers local development with Wrangler, Miniflare, hot reload, debugging. Use for project setup, wrangler.jsonc configuration, or encountering local dev, HMR, binding simulation errors.

secondsky/claude-skills · 47 tokens

cloudflare-workers-performance

Cloudflare Workers performance optimization with CPU, memory, caching, bundle size. Use for slow workers, high latency, cold starts, or encountering CPU limits, memory issues, timeout errors.

secondsky/claude-skills · 42 tokens

orca-k8s-connector-troubleshoot

Diagnoses Kubernetes Connector (K8s Tunnel Client / Helm chart orca-tunnel) install and connectivity failures from raw customer input — error text, helm status, kubectl describe, or pod logs — and walks through step-by-step remediation. Use when a user reports the K8s Connector won't install, won't connect, keeps…

orcasecurity/orca-skills · 92 tokens