CLI Reference
clifi logs
View, stream, and query execution logs from previous CliFi runs.
Synopsis
clifi logs [run-id] [flags]Description
The logs command retrieves execution logs from CliFi's internal log store. By default, it shows the most recent run. Use a run ID to inspect a specific execution, or filter by task, environment, or time range.
In watch mode, logs stream in real-time for currently running workflows. This is useful for tailing CI/CD pipelines or long-running deployments.
Flags
| Flag | Shorthand | Default | Description |
|---|---|---|---|
--task | -t | Filter by task name | |
--env | -e | Filter by environment | |
--since | 1h | Show logs since time (e.g., 1h, 30m, 1d) | |
--level | -l | info | Minimum log level: debug, info, warn, error |
--watch | -w | false | Stream logs in real-time |
--output | -o | pretty | Output format: pretty, json, or raw |
Examples
Show logs from the latest run
bash
clifi logsShow logs for a specific task
bash
clifi logs --task deployStream logs in real-time
bash
clifi logs --watchExport logs as JSON
bash
clifi logs --output json > logs.jsonQuery logs from the last 24 hours
bash
clifi logs --since 1d --level warnSee also
- clifi status - Check workflow status
- clifi run - Execute a workflow