> ## Documentation Index
> Fetch the complete documentation index at: https://opencomputer.manicule.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For every page in one file, fetch https://opencomputer.manicule.dev/llms-full.txt (large).
> To search and read these docs as tools, connect the MCP server at https://opencomputer.manicule.dev/api/mcp.
> Every agent surface: https://opencomputer.manicule.dev/.well-known/llms-manifest.json

# Logs (/agents/logs)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 344 · updated: 2026-08-14 -->
Related: [Serverless Agents](/agents/overview.md), [How it works](/agents/mental-model.md), [Quickstart](/agents/quickstart.md), [Projects and agents](/agents/projects.md), [Reactive agents](/agents/reactive-agents.md), [Sessions and turns](/agents/sessions.md)

> Inspect agent output and outbound-request activity from the OpenComputer CLI

OpenComputer collects agent output together with outbound-request events. Logs
are indexed by project, environment, agent, and session so you can
inspect failures from the project or CLI.

## Read the current agent's logs

From an initialized project:

```bash
npx --package @opencomputer/cli opencomputer logs
```

The CLI uses the local project binding and current agent automatically. Follow
new entries while developing:

```bash
npx --package @opencomputer/cli opencomputer logs --follow
```

## Filter logs

```bash
npx --package @opencomputer/cli opencomputer logs --agent hello-world --environment development
npx --package @opencomputer/cli opencomputer logs --session <session-id>
npx --package @opencomputer/cli opencomputer logs --limit 200
```

Use JSON Lines for scripts and log processors:

```bash
npx --package @opencomputer/cli opencomputer logs --follow --json
```

Each entry includes a stable cursor, timestamp, level, source, message, and
the applicable agent or session identifiers.

## Secret safety

Outbound-request logs describe the connection, method, destination path, status,
and timing. They do not contain injected secret values or secret-bearing
headers. Request headers that could override managed credentials are discarded
before the outbound request is sent.