> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowdeck.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Activity

> Show recent FlowDeck CLI command activity and status

`flowdeck activity` reports recent FlowDeck CLI commands run on this machine, including completed records and any currently active command. Use it to inspect what ran, in what order, and whether it succeeded — useful for debugging automation, CI runs, or agent workflows.

```bash theme={null}
# Show recent activity (default 20 completed records)
flowdeck activity

# Include more history
flowdeck activity --limit 50

# Read only the latest completed command
flowdeck activity --limit 1 --json

# JSON output for scripting
flowdeck activity --json
```

## Options

| Option        | Short | Description                                                  |
| ------------- | ----- | ------------------------------------------------------------ |
| `--limit <n>` |       | Maximum number of completed records to include (default: 20) |
| `--json`      | `-j`  | Output as JSON                                               |
| `--examples`  | `-e`  | Show usage examples                                          |

## What is included

* **Completed records:** the most recent finished commands, up to `--limit`. Each record includes the command, its status (success/failure), and timing.
* **Active command:** if a FlowDeck CLI command is currently running, it is reported alongside the completed history.

<Note>
  `--limit` affects only the recent completed records. The currently active command (if any) is always included regardless of `--limit`.
</Note>

## JSON Output

`flowdeck activity --json` returns a single JSON object with the active command (if any) and the recent completed records, so it can be parsed by scripts and CI to detect the last command's outcome.