# Logs Command

> Run the `synapse-plugin-helper:logs` workflow from the original Claude slash command. Use when the user asks to stream logs from a running Synapse job

- Skill: `datamaker-kr/logs-command` (Agent Skill)
- Install (CLI): `npx skillmds@latest add datamaker-kr/logs-command`
- Raw SKILL.md: https://api.skillmd.com/api/skills/datamaker-kr/logs-command/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: datamaker-kr (https://skillmd.com/u/datamaker-kr)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/datamaker-kr/logs-command

---


<!-- Generated by tools/generate-agent-marketplaces.py; edit the source command or agent-plugin.yaml instead. -->

# synapse-plugin-helper:logs Command Workflow

## Codex Adaptation

- Treat the user request or explicitly supplied text as the command arguments.
- Use the available Codex file, search, terminal, and clarification capabilities that match the workflow.
- Do not depend on Claude-only slash command variables or tool names.

# Stream Synapse Job Logs

View and stream logs from a running or completed Synapse job.

**Arguments:** the user request or explicit arguments

## Workflow

### Step 1: Parse Arguments

- `$1` - Job ID (required)
- `--follow` - Stream logs in real-time (default: false)
- `--host` / `--token` - Backend auth overrides (optional)

If job ID not provided:
```
Please provide a job ID. You can find it from:
- `synapse plugin run <action> --mode job` output
- `synapse plugin job get <job-id>` if you already have the ID
```

### Step 2: Fetch Logs

Execute the log streaming command:

```bash
# Basic log fetch
synapse plugin job logs [job-id]

# Stream logs in real-time
synapse plugin job logs [job-id] --follow

# With explicit backend auth
synapse plugin job logs [job-id] --host https://api.synapse.example.com --token $SYNAPSE_TOKEN
```

### Step 3: Display Output

Format log output with:
- Timestamps
- Log levels (INFO, WARNING, ERROR, DEBUG)
- Progress indicators if available
- Metrics if recorded

### Step 4: Monitor Status

While streaming (`--follow`):
- Show real-time progress updates
- Display metrics as they're recorded
- Alert on errors or warnings
- Notify when job completes

## Log Interpretation

| Level | Meaning |
|-------|---------|
| `INFO` | Normal operation messages |
| `WARNING` | Non-critical issues |
| `ERROR` | Action failures |
| `DEBUG` | Development details |

## Examples

```bash
# View logs for a specific job
/synapse-plugin:logs abc123

# Stream logs in real-time
/synapse-plugin:logs abc123 --follow

# Fetch logs once
/synapse-plugin:logs abc123
```

## Troubleshooting

- **Job not found**: Verify job ID is correct
- **No logs available**: Job may not have started yet
- **Connection lost**: Check network and retry with `--follow`