Thrum

What is textunderstandingd on my Mac?

Last reviewed: 19 November 2026. Path, account, launchd job and man page checked on macOS 26.3.1.

textunderstandingd is the macOS daemon that powers Text Understanding functionality for processing documents. Its launchd job connects it to Spotlight's content stream and names services for smart replies and document understanding. It runs on demand and exits when idle.

textunderstandingd at a glance

textunderstandingd
Made byApple (part of macOS)
TypePer-user agent
Location/usr/libexec/textunderstandingd
Runs asyour user
Started bylaunchd job com.apple.textunderstandingd
Can you quit it?You can, but launchd starts it again when documents need processing.

What is textunderstandingd?

The textunderstandingd(8) man page says it powers Text Understanding functionalities for processing documents. It runs as your user from the com.apple.textunderstandingd launch agent.

Its launchd job registers services with names such as com.apple.TextUnderstanding.SmartReplies.Inference, com.apple.TextUnderstanding.DocumentUnderstandingHarvesting and com.apple.TextUnderstanding.DocumentUpdateHandler, and receivers for Core Spotlight, the framework apps use to give their content to Spotlight. It is also woken when suggestion settings change. The launchd job of suggestd listens for notifications named for Text Understanding pipeline results.

Is textunderstandingd safe?

Yes. textunderstandingd is part of macOS at /usr/libexec/textunderstandingd and runs as your user.

Why does textunderstandingd use so much CPU?

How much CPU is normal for textunderstandingd?

Typical: not running, or short bursts when new content arrives in bulk, such as after a large mail sync.

Continuous activity for hours is not typical.

What can you do if textunderstandingd keeps using CPU?

  1. Let large syncs finish. After adding a mail account or syncing many documents, give it time on power.
  2. Limit learning per app. In System Settings > Apple Intelligence & Siri, Siri Suggestions & Privacy lets you switch off learning from specific apps.
  3. Ask launchd why it is running. launchctl blame gui/$(id -u)/com.apple.textunderstandingd prints what started it.

When should you worry about textunderstandingd?

Worry if it runs at high CPU for long periods without new content, or crashes repeatedly in Console.

A textunderstandingd outside /usr/libexec would not be Apple's.

How do you check textunderstandingd in Activity Monitor and Terminal?

Open Activity Monitor (Applications > Utilities), and type textunderstandingd in the search field. The CPU tab shows its % CPU. Double-click the row for its parent process, memory details and open files.

In Terminal, the first command lists every textunderstandingd process with its PID, user, CPU and memory (RSS is resident memory in kilobytes).

ps -axo pid,user,%cpu,%mem,rss,command | grep -F 'textunderstandingd' | grep -v grep

How can Thrum help with textunderstandingd?

Thrum keeps a live CPU graph in the menu bar. One click shows the eight processes using the most CPU, so you can see when textunderstandingd is among them and how much it takes. An optional alert tells you when a process stays above a CPU level you choose (50 to 200% of one core) for 1 to 10 minutes. Click textunderstandingd in the list for its PID, threads and memory, and Quit or Force Quit it after a confirmation.

Thrum is $4.99 once with a 14-day free trial and no account. It requires macOS 26 Tahoe on Apple silicon or Intel.

Questions about textunderstandingd

Does textunderstandingd read my documents?

Its man page says it processes documents for Text Understanding, and its launchd job receives content through Core Spotlight. Apple does not say more.

Is textunderstandingd part of Spotlight?

It is separate, but it receives content through Core Spotlight receivers in its launchd job.

Sources