---
url: https://docs.mochiexec.io/reference/cli/mochi_logs.md
description: View execution history and logs.
---

# mochi logs

View execution history and logs.

## Synopsis

View execution history recorded in the data store, with associated log output. Optionally filter by executable reference.

```shell
mochi logs [ref] [flags]
```

## Examples

```shell
mochi logs                          # all history
mochi logs --last                   # most recent entry with full output
mochi logs --status failed          # only failed runs
mochi logs --status running         # only in-progress runs
mochi logs --source mcp             # only runs launched by an AI/MCP client
mochi logs --session <id>           # everything one agent session ran
mochi logs run build                # history for 'run build' executable
mochi logs --running                # list active background processes
mochi logs -o json --tail 50        # include the last 50 lines of each run's output
mochi logs --last --grep ERROR      # last run, only lines matching /ERROR/
```

## Options

| Flag | Type | Description |
|------|------|-------------|
| `--client` | `string` | Filter history by the client that launched the run (e.g. 'claude', 'cursor'). |
| `--content` |  | Include each record's log output (json/yaml only; already shown for --last text output). |
| `--grep` | `string` | Include only log lines matching this regular expression (implies --content). |
| `-h, --help` |  | help for logs |
| `--last` |  | Print the last execution's logs |
| `--limit` | `int` | Maximum number of records to display. |
| `--max-bytes` | `int` | Cap included log output to the last N bytes, keeping the tail (implies --content). |
| `-o, --output` | `string` | Output format. One of: yaml, json, or tui. |
| `--running` |  | Show only active background processes. |
| `--session` | `string` | Filter history to a single provenance session ID (e.g. an AI agent session). |
| `--since` | `string` | Filter history to entries after a duration (e.g. 1h, 30m, 7d). |
| `--source` | `string` | Filter history by run origin, e.g. 'cli', 'desktop' or 'mcp'. |
| `--status` | `string` | Filter history by status (running, completed, failed, or cancelled; success/failure accepted as aliases). |
| `--tail` | `int` | Include only the last N lines of log output (implies --content). |
| `-w, --workspace` | `string` | Filter history by workspace name. |

## Options inherited from parent commands

| Flag | Type | Description |
|------|------|-------------|
| `-L, --log-level` | `string` | Log verbosity level (debug, info, fatal) (default "info") |
| `--sync` |  | Sync flow cache and workspaces |

## See also

* [mochi](mochi.md) — Run and organize your development tasks
* [mochi logs attach](mochi_logs_attach.md) — Stream log output from a running background process by run ID.
* [mochi logs clear](mochi_logs_clear.md) — Clear execution history and logs.
* [mochi logs kill](mochi_logs_kill.md) — Terminate a running background process by run ID.