sypho logs
Stream logs and events for a run.
Usage
sypho logs <RUN_ID> [OPTIONS]
Arguments
| Argument | Description |
|---|---|
RUN_ID | Run identifier (e.g., run_8f2a19c4) |
Options
| Flag | Description |
|---|---|
--follow, -f | Stream events in real-time until the run reaches a terminal state |
Examples
View events
sypho logs run_8f2a19c4
Follow events
sypho logs run_8f2a19c4 --follow
Polls for new events (deduplicated by event id) and keeps following run status until it completes or fails.
Event Types
A run's event stream covers the full execution path — a representative sample:
| Type | Description |
|---|---|
step.claimed / step.started | A runner claimed and started the step |
step.completed / step.failed | Step reached a terminal state |
tool.call / tool.result / tool.error | A tool invocation and its outcome |
retrieval.call / retrieval.result | A structured-data access |
skill.loaded | A skill was loaded into context |
agent.loop.start / agent.loop.end | The agent's run loop started or finished |
artifact.created | A run artifact was produced |
API Endpoint
The command polls:
GET /runs/{run_id}/events