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:
- You've pressed Start monitoring,
- the Activity tab is visible and showing the Processes pane, and
- 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, defaultcpu),max_results(default 20),filter(optional name/PID match). - Returns: total process count, rows shown, total CPU %, memory used
and total RAM, plus a
processesarray (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.