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

# charm logs

Fetch recent cloud execution logs for an agent from the terminal.

## Usage

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
charm logs --path . --limit 50
```

## Options

| Option          | Description                                                   |
| --------------- | ------------------------------------------------------------- |
| `--path`        | Path to the Charm project. Defaults to the current directory. |
| `--limit`, `-l` | Number of recent log entries to fetch. Defaults to 50.        |
| `--api-base`    | Override the platform API base URL.                           |
| `--debug`       | Print additional diagnostic output.                           |

## Requirements

* You must be authenticated with `charm auth login`.
* The project must have a `charm.yaml` with an agent ID.
* The agent must have cloud run history.

## When to Use

Use `charm logs` when:

* a published agent fails in the Store,
* a cloud run behaves differently from local execution,
* you need quick terminal access without opening Studio.

For deeper analysis, use the Studio and observability pages in the platform UI.