CLI Commands

pensar logs

Overview

The pensar logs command provides access to agent execution logs for a given issue. You can list logs with filters or search for specific content within the log entries.

Usage

$pensar logs <issueId> [filters]                 # List agent logs
$pensar logs search <issueId> <query> [options]  # Search agent logs

Prerequisites

You must be connected to Pensar Console via pensar auth login before using this command.

Subcommands

List Logs

$pensar logs <issueId> [filters]

Lists agent execution logs for an issue. Returns a JSON array.

FilterDescription
--level <level>Filter by: debug, info, warn, error
--role <role>Filter by: assistant, user, system, tool-call, tool-result
--limit <n>Max entries to return (default: 100, max: 500)

Search Logs

$pensar logs search <issueId> <query> [options]

Searches log entries for a given query string.

OptionDescription
--level <level>Filter by: debug, info, warn, error
--role <role>Filter by: assistant, user, system, tool-call, tool-result
--context <n>Number of context lines around matches (default: 3)

Examples

$# List all logs for an issue
$pensar logs issue_ghi789
$
$# List only error-level logs
$pensar logs issue_ghi789 --level error
$
$# List tool call logs with a limit
$pensar logs issue_ghi789 --role tool-call --limit 50
$
$# Search logs for a specific term
$pensar logs search issue_ghi789 "SQL injection"
$
$# Search with filters
$pensar logs search issue_ghi789 "timeout" --level warn --context 5
pensar issues

View the issues these logs relate to

pensar fixes

View suggested fixes for issues