All pages

Docs · Right-sidebar surfaces

Activity Monitor

Availability: macOS · cloud workspace (activity_list / activity_kill).

The Activity tab in the right sidebar (under the More menu) has two panes: Processes — a live, system-wide process table sorted by CPU or memory — and History — a recorded CPU / memory trace with saved periods. Use it to spot what's eating your machine without leaving TRMNLY; the agent can read the same data through tools.

It's system-wide (backed by ps -A and kernel counters), not scoped to TRMNLY's own processes.

Processes

Sampling is off by default and only runs when all three hold:

  1. You've pressed Start monitoring,
  2. the Activity tab is visible and showing the Processes pane, and
  3. TRMNLY is the active app.

This keeps the monitor from burning CPU in the background. When paused, the panel explains why. The header shows a process count when running.

Each row lists the process name and PID, its CPU %, and memory (RSS). The footer sums total CPU across sampled processes and shows physical memory used out of total RAM.

A row also carries the icon of the nearest bundle that has one. An app wears its own; a helper or an extension wears the icon of the app it belongs to, so a renderer burning a core reads as Chrome rather than as an anonymous row. Daemons and loose binaries — most of /usr/libexec — stay bare, because a generic placeholder on every one of them is noise dressed as information. The name column still says exactly which process it is either way.

Control Options
Sort CPU or Memory (persisted)
Filter Match by name or PID (case-insensitive substring)
Refresh 1 / 2 / 5 / 10 seconds (default 2s)
Row cap Top 25 / 50 / 100 / 500 (default 50)

Quitting a process

Hover a row and click the ⨯ at its right edge to quit it (SIGTERM); hold ⌥ while clicking to force quit (SIGKILL). Right-clicking offers the same two plus Copy PID. Either way you get a confirmation first, and the list re-samples straight after so the row goes away without waiting for the next refresh tick.

TRMNLY can only signal processes you own. Rows belonging to another user — root-owned system daemons, which is most of what sorts to the top of a CPU list — show the ⨯ dimmed and say so on hover, because kill(2) can only fail there. Quit those from Activity Monitor.app, which can ask for an administrator password; TRMNLY deliberately doesn't.

History

History answers "what happened while I wasn't looking":

  • Press the record button to start. Recording is off by default, but the choice persists across relaunches. Each sample is a cheap kernel read — no process listing — every 2–60 seconds (default 5s), and it keeps running while TRMNLY is in the background.
  • Full-resolution samples are kept for 1–24 hours (default 6); one-minute rollups storing the average and the peak are kept 1–30 days (default 7).
  • Attribution (on by default) also records the top CPU / memory processes on a slower cadence.
  • Drag across a chart to select a span, then Save it as a named period. A period freezes its own copy of the samples, so it survives after the live history rolls off. Right-click a period to rename it, edit its note, export CSV / JSON, or delete it.
  • The settings menu holds the interval / retention / attribution controls, Open in Window (a larger detached view), and Erase Recorded History.

Agent tools

The read-only activity_monitor tool (no approval needed) returns the same process snapshot:

  • Parameters: sort_by (cpu | memory, default cpu), max_results (default 20), filter (optional name/PID match).
  • Returns: total process count, rows shown, total CPU %, memory used and total RAM, plus a processes array (pid, ppid, name, cpu_percent, mem_percent, rss_bytes).

History has its own tools: activity_history (query the recorded trace or a saved period), activity_recording (status / start / stop), activity_period_save, activity_period_list, and activity_period_delete (the only one that needs approval).

This is a different system from Tab Monitor, which tracks processes spawned within a tab rather than the whole machine.