sypho logs
View logs and events for a run.
Usage
sypho logs <RUN_ID> [OPTIONS]
Arguments
| Argument | Description |
|---|---|
RUN_ID | Run identifier (e.g., run_abc123) |
Options
| Flag | Description |
|---|---|
--follow, -f | Stream logs in real-time |
--json | Output as JSON |
Examples
View Logs
sypho logs run_abc123
Output:
[2026-07-10 10:00:01] Agent started
[2026-07-10 10:00:02] Calling tool: example_tool
[2026-07-10 10:00:03] Tool result: SUCCESS
[2026-07-10 10:00:04] Execution complete
Follow Logs
sypho logs run_abc123 --follow
Streams logs as they arrive (like tail -f).
JSON Output
sypho logs run_abc123 --json
Output:
[
{
"timestamp": "2026-07-10T10:00:01.000Z",
"type": "agent.log",
"message": "Agent started"
},
{
"timestamp": "2026-07-10T10:00:02.000Z",
"type": "tool_call",
"tool": "example_tool",
"args": {...}
}
]
Event Types
| Type | Description |
|---|---|
agent.log | Agent stdout/stderr |
tool_call | Tool invocation |
tool_result | Tool response |
llm_call | LLM API request |
llm_response | LLM API response |
step.completed | Step finished |
step.failed | Step failed |
API Endpoint
The command calls:
GET /runs/{run_id}/events