logs

The logs skill provides a powerful interface for developers and support teams to inspect the performance and history of Vocal Bridge voice agents. By leveraging the underlying Vocal Bridge CLI, this tool allows you to retrieve call metadata, full text transcripts, and session diagnostics without leaving your development environment. It is an essential utility for debugging agent behavior, verifying conversation quality, and auditing customer interactions. Whether you are performing quality assurance on a customer service bot or investigating a specific failed call, the logs skill bridges the gap between raw data in the cloud and actionable insights in your workspace.

• Retrieves detailed session metadata including UUID, caller phone number, connection direction, and total duration.

• Offers robust filtering capabilities by call status (completed, failed, abandoned, or in-progress) and result counts.

• Provides full access to conversation transcripts, enabling rapid review of agent-user dialogue flow.

• Supports JSON output for machine-readable piping, allowing integration with external data analysis scripts or custom reporting tools.

• Simplifies error tracking by exposing failure reasons and identifying specific session identifiers for further troubleshooting.

• Ensure the vocal-bridge CLI is installed via pip for proper command execution.

• Use the session UUID as a direct argument to pull granular details for a specific interaction.

• Utilize the -n flag to limit the number of logs returned, helping to manage high-volume data streams effectively.

• Pair this skill with the download tool to retrieve audio recordings of calls when available.

• Combine with status filtering to quickly isolate problematic calls for post-mortem analysis.

• The tool is designed to work seamlessly within the Claude Code environment, utilizing the same authentication context as other Vocal Bridge plugin commands.