proc stats — Monitor your session's memory, CPU usage,…

Pitch

Description

Comments

About this project

proc-stats enhances Claude Code by providing a comprehensive status line that displays critical resource metrics, including memory usage, CPU load, and uptime. With a dedicated task-manager pane on /proc-stats, users can monitor processes, visualize trends, and manage resources in real-time, ensuring efficient session management.

proc-stats is a powerful Claude Code modification designed to enhance session monitoring by providing real-time insights into resource usage, including memory and CPU statistics, as well as session uptime. It features a dedicated task-manager pane accessible through the /proc-stats command, enabling users to effectively track their session's performance with an intuitive interface.

Key Features

Resource Tracking: Displays the current memory usage, peak memory, CPU share, and session uptime in a clear format:
```
mem 484MB · peak 530MB · cpu 2.4% · up 12m 4s
```
Detailed Process Management: The /proc-stats pane lists all current processes along with their resource usage, allowing for easy monitoring and management of both active and detached processes. This includes features like sorting, expanding or collapsing process trees, and terminating processes directly from the pane:
```
mem (484 + 215)MB · peak 530MB · cpu (2.4 + 98.7)% · up 12m 4s
```
Visual Charting: The top of the task manager provides historical charts for CPU and memory usage, scaling dynamically based on collected data, making it easier to identify trends and performance issues over time.
Customizable Alerts: Users can configure alert thresholds for memory and CPU usage, which are visually represented in the status line. A yellow or red warning indicates exceeding set limits, helping prevent potential performance degradation:

Alert Type Memory (MB) CPU (%)
Warning 2048 150
Alert 4096 300

Alert Type	Memory (MB)	CPU (%)
Warning	2048	150
Alert	4096	300

Platform Compatibility

proc-stats operates on multiple platforms, including Linux, macOS, and Windows. It refreshes data at different intervals depending on the operating system to ensure optimal performance without causing excessive resource strain:

Linux: Every second
macOS: Every two seconds
Windows: Every five seconds

Installation

Install proc-stats seamlessly into a Claude Code session using the command:

/plugin install proc-stats --marketplace DragosMocrii/proc-stats

This modification provides a straightforward way to maintain awareness of system resource usage and application performance, making it an essential tool for developers working with Claude Code.

Visit proc-stats