GitHub repositories · by Si Nguyen

watch-my-ram: a Claude Code mod to keep an eye on your Mac's memory

Name: watch-my-ram: a Claude Code mod to keep an eye on your Mac's memory
Author: Si Nguyen

A small open-source Claude Code mod that shows RAM usage and memory pressure above the prompt and adds a /watch-my-ram command listing active sessions, leftover dev processes and open ports. It only reads and warns — it never kills anything automatically.

Si Nguyen@nguyenphusi13

Running multiple Claude Code sessions in parallel is great. Until my 16 GB Mac starts yelling at me. Idle sessions, leftover dev servers, orphaned processes, all eating up memory. So I built watch-my-ram, a small Claude Code mod to keep an eye on my Mac's memory. Here's what it does: • Shows RAM usage and memory pressure right above the prompt. • /watch-my-ram lists active sessions, their memory usage, PR merge status, leftover dev processes, and open ports. • Warns when Claude starts running tests while another session is already testing. It only reads and warns. It doesn't kill anything automatically. You can ask Claude for suggestions and decide what to close. It's open source. Link to repo: https://github.com/nguyenphusi/watch-my-ram P.S. A better solution is probably getting a new Mac with more RAM though 😂

Translated

About this mod

Running multiple Claude Code sessions in parallel is great. Until my 16 GB Mac starts yelling at me. Idle sessions, leftover dev servers, orphaned processes, all eating up memory.

So I built watch-my-ram, a small Claude Code mod to keep an eye on my Mac's memory.

Here's what it does: • Shows RAM usage and memory pressure right above the prompt. • /watch-my-ram lists active sessions, their memory usage, PR merge status, leftover dev processes, and open ports. • Warns when Claude starts running tests while another session is already testing.

It only reads and warns. It doesn't kill anything automatically. You can ask Claude for suggestions and decide what to close.

It's open source. Link to repo: https://github.com/nguyenphusi/watch-my-ram

Installation

Check the author's README for the marketplace and plugin name first. Commands may change as the repository evolves.

claude plugin marketplace add nguyenphusi/watch-my-ram
claude plugin install watch-my-ram@watch-my-ram

Original text / README

Running multiple Claude Code sessions in parallel is great. Until my 16 GB Mac starts yelling at me.

Idle sessions, leftover dev servers, orphaned processes, all eating up memory.

So I built watch-my-ram, a small Claude Code mod to keep an eye on my Mac's memory.

Here's what it does:

• Shows RAM usage and memory pressure right above the prompt.

• /watch-my-ram lists active sessions, their memory usage, PR merge status, leftover dev processes, and open ports.

• Warns when Claude starts running tests while another session is already testing.

It only reads and warns. It doesn't kill anything automatically. You can ask Claude for suggestions and decide what to close.

It's open source. Link to repo: https://github.com/nguyenphusi/watch-my-ram

P.S. A better solution is probably getting a new Mac with more RAM though 😂

Get a badge

Is this your project? Add this badge to your README or website. It links back to this page.

Size Small Large

Theme Light Dark

Markdown

[![Featured on ClaudeMods](https://claudemods.dev/badge/running-multiple-claude-code-sessions-in-parallel-is-great-u-4cd372.svg)](https://claudemods.dev/en/builds/running-multiple-claude-code-sessions-in-parallel-is-great-u-4cd372)

HTML

<a href="https://claudemods.dev/en/builds/running-multiple-claude-code-sessions-in-parallel-is-great-u-4cd372"><img src="https://claudemods.dev/badge/running-multiple-claude-code-sessions-in-parallel-is-great-u-4cd372.svg" alt="Featured on ClaudeMods" height="20" /></a>

Project information

Author: Si Nguyen
Use cases: Memory & context
Added: Nov 13, 2026
Source updated: Nov 13, 2026
Stars: 0
Permission footprint: L2
views: 0
Source engagement:: 4 likes · 39 views

hooks macos memoryprocess-monitoringslash-command statusline

Report this work Is this your work? Claim it

Permission footprint

Automatically scanned data. Review the source before installing. Levels describe capabilities, not a safety certification.

Environment variables
Execute commands
Read files
Write files
Intercept tool calls

View matches (21）

Environment variables · line81 linehooks/register.tsxconst home = await $.env.get('HOME')

Execute commands · line87 linehooks/register.tsxconst ran = await $.process.run(MEASURE_ARGV, { timeoutMs: 5000 })

Read files · line113 linehooks/register.tsxconst stat = await $.fs.stat(path).catch(() => undefined)

Read files · line115 linehooks/register.tsxfound = parseSample(await $.fs.read(path).catch(() => ''))

Write files · line121 linehooks/register.tsxawait $.fs.write(path, JSON.stringify(found)).catch(() => undefined)

Execute commands · line154 linehooks/register.tsxreturn parseSnapshot((await $.process.run(PS_ARGV, { timeoutMs })).stdout)

Environment variables · line170 linehooks/register.tsx$.env.get('HOME'),

Execute commands · line180 linehooks/register.tsx

$.process.run(['/usr/sbin/lsof', '-nP', '-iTCP', '-sTCP:LISTEN', '-Fpcn'], { timeoutMs: 10_000 }).catch(() => undefined),

Intercept tool calls · line440 linehooks/register.tsxon('tool.call', { tool: 'Bash' }, async ($, e, next) => {

Execute commands · line476 linehooks/register.tsxconst ran = await $.process.run(repoArgv(folders), { timeoutMs: 30_000 }).catch(() => undefined)

Execute commands · line537 linehooks/register.tsxreturn await $.process.run([gh, ...args], { cwd, timeoutMs: 15_000 })

Execute commands · line15 linehooks/lib/memory.tsconst pageSize = Number(/page size of (\d+) bytes/.exec(text)?.[1])

Execute commands · line17 linehooks/lib/memory.tsconst match = new RegExp(`^${label}:\\s+(\\d+)\\.?$`, 'm').exec(text)

Execute commands · line34 linehooks/lib/memory.tsconst match = /used = ([\d.]+)([KMG])/.exec(text)

Execute commands · line43 linehooks/lib/memory.tsconst bytes = Number(/^(\d{8,})\s*$/m.exec(text)?.[1])

Execute commands · line54 linehooks/lib/memory.tsconst level = Number(/^kern\.memorystatus_vm_pressure_level:\s*(\d+)\s*$/m.exec(text)?.[1])

Execute commands · line32 linehooks/lib/processes.tsconst match = /^(?:(\d+)-)?(?:(\d+):)?(\d+):(\d+)$/.exec(etime)

Execute commands · line47 linehooks/lib/processes.tsconst match = /^\s*(\d+)\s(.+)$/.exec(line)

Execute commands · line52 linehooks/lib/processes.tsconst match = LINE.exec(line)

Execute commands · line111 linehooks/lib/processes.tsconst folder = /(\/\S*?)\/node_modules\//.exec(args)?.[1]

Execute commands · line43 linehooks/lib/roll-call.tsconst port = Number(/:(\d+)$/.exec(line)?.[1])

watch-my-ram: a Claude Code mod to keep an eye on your Mac's memory

About this mod

Installation

Get a badge

Similar projects

Context Diet: a Claude Code mod that keeps huge tool outputs from flooding the context

working-memory

idle-compact

context-lens

"Done" isn't a handoff if the next person has to hunt for the file. Crew keeps A

lcm