Skip to content
Back to search

Resource-Management

Lightweight macOS memory monitor: finds who eats RAM, kills safely, memory guard with idle-orphan cleanup. Rust + Tauri, CLI and MCP server for Claude Code.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/leoerdman--resource-management/badge.svg)](/listings/leoerdman--resource-management)

HTML

<a href="/listings/leoerdman--resource-management"><img src="/api/listings/leoerdman--resource-management/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requirements: Rust (stable, 1.89+), Node.js 22+, Xcode Command Line Tools.

git clone https://github.com/leoerdman/Resource-Management.git
cd Resource-Management
scripts/install-macos.sh          # add --dmg to also build a .dmg installer

This builds the app, installs it to `/Applications/Resource Monitor.app`, and links the CLI to `~/.local/bin/rmon`. The build is signed ad hoc, without a Developer ID.

Connect to Claude Code:

claude mcp add --scope user rmon -- "/Applications/Resource Monitor.app/Contents/MacOS/rmon" mcp

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 123 lines
  1. # Resource Management
  2. **Resource Monitor** is a lightweight macOS memory monitor for people who run a lot of dev tooling
  3. and AI agents at once. Activity Monitor shows the numbers. Resource Monitor answers the questions
  4. behind them: **who is eating memory, is it still growing, is it still needed, and is it safe to kill?**
  5. It also ships a **memory guard** that steps in when the Mac runs low on memory. It also cleans up
  6. orphaned dev processes that sit idle. Both act through the same safety layer, so your apps and
  7. system processes are never touched.
  8. > **Status:** macOS 13+. The interface is in Russian for now.
  9. > Linux and Windows are planned (see [ROADMAP](docs/ROADMAP.md)).
  10. ![Suspects: what to clean up and why](docs/screenshots/suspects.png)
  11. ## Features
  12. - **Suspects.** Processes that are big, growing, orphaned (parent died), idle, or abandoned
  13. duplicates. Each comes with a score, a plain-language reason, how much it would free, and whether
  14. it is safe to kill.
  15. - **Real memory numbers.** Memory pressure and its 15-minute history, plus a breakdown into app,
  16. wired, compressed, cache and free, and swap. The totals match Activity Monitor.
  17. - **Apps and processes.** Helpers are grouped under their app. For `claude`, `node`, `tsgo` and
  18. similar processes the project they run in is shown. Filter by name, path or command line.
  19. - **Process details.** Full command line, working directory, parent chain, children, and a memory
  20. graph.
  21. - **Memory guard.**
  22. - When memory pressure stays red, the guard kills the largest build or test run (`tsgo`, `tsc`,
  23. `vitest`, `jest`, `node`, `bun`), names the project and session that started it, and sends a
  24. notification.
  25. - **Orphan auto-cleanup**, on by default: an orphaned dev process that has used no CPU and kept
  26. the same memory for N minutes (default 5) is killed in any zone.
  27. - Rate limits, a dry-run mode, and a per-kill journal.
  28. - **Menu bar icon.** It shows pressure as a color plus memory used, and has a guard toggle.
  29. The app starts at login.
  30. - **Safety layer.** Before every kill it checks that the PID still belongs to the same process.
  31. It sends SIGTERM, waits, then SIGKILL. System processes are never touched. Your apps (browsers,
  32. editors, Claude, Telegram…) need explicit confirmation. Every action is logged.
  33. - **CLI `rmon`.** Commands: `status`, `ps`, `suggest`, `why <pid>`, `kill <pid>`, `guard …`,
  34. `config`. All of them support `--json`.
  35. - **MCP server for Claude Code.** Run `rmon mcp` and Claude can inspect memory and clean up through
  36. the same safety layer. It asks you before touching your apps. See [docs/CLAUDE_CODE.md](docs/CLAUDE_CODE.md).
  37. | Process details | Memory guard |
  38. |---|---|
  39. | ![Process details](docs/screenshots/details.png) | ![Memory guard and orphan cleanup](docs/screenshots/guard.png) |
  40. ![Apps](docs/screenshots/apps.png)
  41. ## Install (macOS)
  42. Requirements: Rust (stable, 1.89+), Node.js 22+, Xcode Command Line Tools.
  43. ```bash
  44. git clone https://github.com/leoerdman/Resource-Management.git
  45. cd Resource-Management
  46. scripts/install-macos.sh # add --dmg to also build a .dmg installer
  47. ```
  48. This builds the app, installs it to `/Applications/Resource Monitor.app`, and links the CLI to
  49. `~/.local/bin/rmon`. The build is signed ad hoc, without a Developer ID.
  50. Connect to Claude Code:
  51. ```bash
  52. claude mcp add --scope user rmon -- "/Applications/Resource Monitor.app/Contents/MacOS/rmon" mcp
  53. ```
  54. ## Configuration
  55. All settings can be changed in the app and are saved to `~/.config/rmon/config.toml` (your comments
  56. in that file are kept). The guard's allow and never lists, the kill policy and the thresholds can
  57. also be edited there. Run `rmon config` to show the file, the log paths, and any rule errors.
  58. ```toml
  59. [guard]
  60. enabled = true
  61. dry_run = false
  62. [guard.orphans] # orphan auto-cleanup
  63. enabled = true
  64. idle_mins = 5
  65. ```
  66. Logs (JSONL, kept for 24 h) live in `~/Library/Logs/rmon/`: `actions.jsonl` records kills and
  67. refusals, `guard.jsonl` records guard decisions, and `timeline.jsonl` records a state snapshot
  68. every minute.
  69. ## Development
  70. ```bash
  71. cargo test --workspace # also regenerates TS types in apps/rmon-app/src/bindings
  72. cd apps/rmon-app && npm ci && npm test
  73. npm run dev # UI in a browser with a mock backend (demo data)
  74. npx tauri dev # the real app
  75. ```
  76. Layout: `crates/rmon-core` holds collection, analysis, kill policy and the guard. `crates/rmon-cli`
  77. is the CLI, `crates/rmon-mcp` is the MCP server, and `apps/rmon-app` is the Tauri 2 + React app.
  78. The design and its decisions are in [docs/SPEC.md](docs/SPEC.md).
  79. ## License
  80. [MIT](LICENSE)
  81. ---
  82. ## По-русски
  83. **Resource Monitor** — лёгкий монитор памяти для macOS. Он отвечает на вопросы, на которые не
  84. отвечает Activity Monitor: кто съел память, растёт ли он, нужен ли он ещё и можно ли его снять
  85. безопасно.
  86. - В окне вкладки «Подозреваемые», «Приложения», «Процессы», «Журнал», «Сторож» и «Настройки».
  87. В строке меню — значок, окрашенный по давлению памяти.
  88. - **Сторож памяти.** В красной зоне он сам снимает самый большой прогон сборки или тестов.
  89. **Автоочистка сирот** (включена по умолчанию) снимает брошенный dev-процесс, если тот N минут
  90. не тратит CPU и не меняет память.
  91. - Все снятия проходят через защитный слой. Системные процессы защищены, ваши приложения — только с
  92. подтверждением, каждое действие пишется в журнал.
  93. - Есть CLI `rmon` и MCP-сервер для Claude Code.
  94. Установка: `scripts/install-macos.sh`. Пока только macOS 13+, Linux и Windows — в планах.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.