peeka-diagnostics

Diagnose live Python processes with peeka-cli to identify bottlenecks and memory leaks.

6|1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/wwulfric/peeka --skill peeka-diagnostics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: peeka-diagnostics
Source: https://github.com/wwulfric/peeka/tree/main/.agents/skills/peeka-diagnostics
Command: npx skills add https://github.com/wwulfric/peeka --skill peeka-diagnostics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Diagnosing live Python applications non-invasively to identify slowdowns, memory leaks, thread contention, and misbehavior without requiring code changes.

Core Features & Use Cases

  • Non-invasive runtime diagnostics via peeka-cli for live Python processes.
  • Observability commands such as watch, trace, stack, memory, and thread to inspect behavior and performance.
  • Guided workflows with environment detection, permission checks, and diagnostic playbooks to reproduce issues safely.

Quick Start

Install peeka-cli for Python 3.8+ and attach to a running process with peeka-cli attach <pid>, then begin observations with a simple watch command such as peeka-cli watch 'module.func' -n 5.

Frequently Asked Questions about peeka-diagnostics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose a live Python process without changing code?

Non-invasive runtime diagnostics let you diagnose a live Python process without code changes. You attach a diagnostic tool to the running process to inspect performance bottlenecks, memory leaks, and thread issues directly.

What can I trace in a running Python application to find bottlenecks?

You can trace function calls, watch variables, inspect thread stacks, and analyze memory in a running Python application. These observability commands identify bottlenecks and misbehavior without requiring application restarts or modifications.

Can I use runtime tracing tools on Python apps in production?

Yes, runtime tracing applies to debugging Python applications in both development and production. Guided workflows include environment detection and permission checks to ensure safe diagnostic processes when inspecting live production environments.

What's the best way to watch a variable in a live Python app?

The best way to watch a variable is attaching to the live Python process and targeting the specific function. You execute a watch command on the module function to observe variable values across multiple executions without altering source code.

Do I need root permissions to inspect thread issues in Python processes?

Inspecting thread issues requires passing permission checks within the diagnostic workflow. The tool performs environment detection and validates permissions before attaching to ensure safe and authorized access to the live Python process.