railway agent

Interact with the Railway Agent directly from the CLI. Ask questions about your project, create resources, debug issues, and more using natural language. Starts an interactive session by default, or send a single prompt with the -p flag.

Usage

railway agent [OPTIONS]

Options

Flag	Description
`-p, --prompt <MESSAGE>`	Send a single prompt (omit for interactive mode)
`--json`	Output response as JSON
`--list`	List existing agent threads for the current environment
`--thread-id <ID>`	Continue an existing chat thread (replays recent history)
`-s, --service <SERVICE>`	Service to scope the conversation to (name or ID)
`-e, --environment <ENV>`	Environment to use (defaults to linked environment)

Examples

Start an interactive session

railway agent

Show logs for your project

railway agent -p "show me the logs for my project"

Create a database

railway agent -p "create a PostgreSQL database in this project"

Debug a failing service

railway agent -p "help me debug why my backend service is failing"

Check deployment status

railway agent -p "what's the status of my latest deployment?"

Investigate resource usage

railway agent -p "show me the memory and CPU usage for my services"

Scope to a specific service

railway agent -p "check the logs for errors" --service backend

Get configuration help

railway agent -p "what environment variables are set on my project?"

JSON output for scripting

railway agent -p "list my services and their status" --json

List previous conversations

railway agent --list

Returns the agent threads tied to the current environment, with their thread IDs, titles, and last-updated timestamps. Add --json for a machine-readable list.

Continue a previous conversation

railway agent --thread-id <THREAD_ID>

When you resume a thread, the agent replays the recent message history before dropping you into interactive mode, so you can pick up where you left off. Pair with --list to find the thread ID you want.

Interactive mode

When run without -p, the agent starts an interactive session where you can have a back-and-forth conversation:

$ railway agent
Railway Agent (type 'exit' or Ctrl+C to quit)

> You: what services do I have?

Railway Agent: You have 3 services...

> You: show me the logs for the backend

Railway Agent: Here are the recent logs...

> You: exit

The agent maintains context within the session, so follow-up questions understand previous messages.

JSON output

Use --json to get a structured response for scripting and automation:

railway agent -p "list my services" --json

Returns a JSON object with:

{
  "threadId": "abc-123",
  "response": "You have 3 services...",
  "toolCalls": [
    {
      "toolName": "environmentStatusTool",
      "args": { ... },
      "result": { ... },
      "isError": false
    }
  ]
}

Authentication

The agent command requires user authentication via railway login. Project access tokens (RAILWAY_TOKEN) are not supported.