Skip to content

docs(cli): document railway agent --list and resume-with-history #1148

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
codyde merged 1 commit into from
May 12, 2026
Merged

docs(cli): document railway agent --list and resume-with-history #1148

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions content/docs/cli.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -223,6 +223,8 @@ railway functions push # Push function changes
```bash
railway agent # Chat with the Railway Agent
railway agent -p "..." # Send a single prompt
railway agent --list # List previous agent threads
railway agent --thread-id <ID> # Resume a previous thread
railway setup agent # Configure Railway agent tooling
railway mcp install # Configure MCP for AI coding tools
railway skills install # Install Railway agent skills
Expand Down
13 changes: 12 additions & 1 deletion content/docs/cli/agent.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,8 @@ railway agent [OPTIONS]
|------|-------------|
| `-p, --prompt <MESSAGE>` | Send a single prompt (omit for interactive mode) |
| `--json` | Output response as JSON |
| `--thread-id <ID>` | Continue an existing chat thread |
| `--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) |

Expand Down Expand Up @@ -77,12 +78,22 @@ railway agent -p "what environment variables are set on my project?"
railway agent -p "list my services and their status" --json
```

### List previous conversations

```bash
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

```bash
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:
Expand Down
Loading