Skip to content
OpenComputer
Test and operate

Logs

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:

npx --package @opencomputer/cli opencomputer logs

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

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

Filter logs

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:

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.