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

<issueId> accepts either the issue UUID or its label — e.g. VULN-000123.

Prerequisites

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

Subcommands

List Logs

pensar logs <issueId> [filters]

Lists agent execution logs for an issue. Returns a JSON object with issueId, totalLogs, returnedLogs, and a logs 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 VULN-000123
# List only error-level logs
pensar logs VULN-000123 --level error
# List tool call logs with a limit
pensar logs VULN-000123 --role tool-call --limit 50
# Search logs for a specific term
pensar logs search VULN-000123 "SQL injection"
# Search with filters
pensar logs search VULN-000123 "timeout" --level warn --context 5
pensar issues

View the issues these logs relate to

pensar fixes

View suggested fixes for issues