OneMacTools documentation
Everything about how OneMacTools works on your Mac: installing it, the ways to start a tool, what happens while a job runs, every Your Mac screen, on-device AI, connecting AI assistants, settings, your licence and privacy.
Each tool's own steps and options are on its page: All 151 tools
Getting started
Install OneMacTools on your Mac: requirements, setup, updates and uninstallingHow to install OneMacTools on a Mac: system requirements, the DMG, first launch and activation, permissions, automatic updates and a clean uninstall.A tour of the OneMacTools interfaceFind your way around the OneMacTools interface: the sidebar, Discover and Today, tool cards and search, the tool screen and its Options panel, and the menu bar icon.How to use OneMacTools tools: add files, set options, run and find your resultsHow to use OneMacTools tools: add files by drag and drop or iPhone scan, set options and presets, preview the result, run a batch and find the output folder.Every OneMacTools keyboard shortcutEvery OneMacTools keyboard shortcut in one place: menu commands, ⌘K Ask, global hotkeys like ⌃⌥⌘F Quick Search, tool and recorder keys, and how to change them.
Ways to run a tool
Finder Quick Actions on Mac: right-click to compress, convert and moreFinder Quick Actions on Mac from OneMacTools: right-click to compress a video, merge PDFs or convert images, without opening an app. Every action and fix.Ask (⌘K): natural language file search and commands on MacNatural language file search on Mac: type “merge the PDFs from Gmail this week” and OneMacTools finds the files and opens the tool. How Ask works.Quick Search: search files from any app on Mac (⌃⌥⌘F)Search files from any app on Mac: press ⌃⌥⌘F for OneMacTools Quick Search across your Mac and every cloud, with plain-English queries. How it works.Watch Folders: automatically process new files on MacAutomatically process new files on Mac with OneMacTools Watch Folders: compress screenshots, file invoices or trash old installers the moment they land.Apple Shortcuts and Siri: automate file tools on Mac with OneMacToolsApple Shortcuts Mac file automation: run any OneMacTools tool from Shortcuts, Siri or an automation, with presets, and get the result files back. Examples inside.Mac desktop widgets: Mac Health, memory, batteries, free space and filesMac desktop widgets from OneMacTools: Mac Health, Memory, Batteries, Free Space, Every Cloud and Recent Files. What each shows, sizes, and how they update.
Jobs & history
Batch processing files on Mac: progress, cancelling and finished jobsBatch process files on Mac with OneMacTools: the progress screen, time left, cancelling, background jobs and notifications, and what happens when a file fails.OneMacTools History: every job you've run, from anywhereOneMacTools History lists every job from the app, Finder, the menu bar, Watch Folders, Shortcuts and AI assistants, with Preview, Show in Finder and Put Back.
Your Mac
OneMacTools Home: your Mac’s storage, downloads and next steps on one screenOneMacTools Home shows free space, your Downloads, what Clean Up can free and where files came from, with a one-click next step for every new file.Mac Clean Up: clean up Mac storage safely, with everything going to the TrashMac Clean Up finds old installers, big videos, duplicates, similar photos and cloud copies. Everything goes to the Trash and can be put back. See how it works.Explore Disk: a disk space map that shows what’s taking up space on your MacExplore Disk shows every folder on your Mac by size, as a list or a disk space map, with a label for what each one is and safe ways to clear it.Mac Health: see which app is using your CPU, memory and batteryA Mac Activity Monitor alternative that names the app behind a slow Mac: one row per app with CPU, memory, GPU, power, disk and network, and a plain-English verdict.Check your Mac's CPU temperature, fan speed, GPU and Neural EngineA Mac CPU temperature monitor that also shows fan speed, GPU and Neural Engine use, and whether macOS is slowing your Mac down to keep cool. Read only.Check your Mac's battery health, cycle count and power drawCheck battery health on your Mac: health percentage, cycle count, watts, time left, and the apps using power now and since you unplugged, plus AirPods batteries.Mac performance history, trends and alertsMac performance history for the whole Mac and every app: charts up to a year back, click a spike to see the culprit, trends like disk full in 39 days, and alerts.Menu bar system monitor: live CPU, memory and more in your Mac's menu barA Mac menu bar system monitor: CPU, memory, disk, network, battery, temperature, GPU and microphone readouts, the busiest apps, per-app volume and quick tools.Files: search iCloud, Google Drive, OneDrive and Dropbox at once on your MacSearch iCloud Drive, Google Drive, OneDrive, Dropbox, Box and your Mac at once, in plain English, without downloading a thing. How the Files screen works.Downloaded From: find where a file was downloaded from on your MacDownloaded From groups every download on your Mac by where it came from: Gmail, WhatsApp, ChatGPT, Slack, AirDrop and any website. Search it or automate it.Life Admin: track passport, licence and insurance expiry dates on your MacTrack passport, licence and insurance expiry dates on your Mac. Life Admin reads your papers on-device and reminds you 30 and 7 days before anything runs out.Organise tax documents and make an emergency document kit on your MacOrganise tax documents on your Mac into a Tax Pack for your accountant, back up papers kept only here, and make an encrypted emergency document kit for family.Manage dev servers, ports, Docker and build folders on your MacManage dev servers and ports on Mac: see every server by project, spot idle ones, stop them safely, tidy Docker and clear old node_modules in one screen.Monitor Claude Code, Codex and other AI coding agent sessions on your MacMonitor Claude Code and Codex sessions on your Mac: see what each agent started, its memory and CPU, Codex and Claude Code usage limits, and stop a session safely.AI Space: see and clear what AI apps store on your MacAI Space shows what Cursor, Claude, ChatGPT, Codex, Ollama and 20 other AI apps store on your Mac, ticks caches safe to clear and finds leftovers of removed apps.
AI
On-device AI on your Mac: which OneMacTools features use Apple IntelligenceOn-device AI on Mac: which OneMacTools tools use Vision, Speech, Translation or Apple Intelligence, what works offline, and what needs Apple Intelligence on.Use OneMacTools as an MCP server for Claude, Claude Code, Cursor and CodexSet up OneMacTools as an MCP server on your Mac in one click for Claude Desktop, Claude Code, Cursor or Codex. See every tool it exposes and how approvals work.AI assistant permissions: how OneMacTools asks before Claude or Cursor actsAI assistant permissions in OneMacTools: what Claude, Cursor or Codex can read freely, what always needs your Allow, sensitive-data warnings and the audit trail.
Customise
OneMacTools themes: Liquid Glass, Classic, Neo-brutal and RetroOneMacTools themes change the whole window, not just colours. See how Liquid Glass, Classic, Neo-brutal and Retro differ, and how to switch in a click.OneMacTools settings: every option explainedOneMacTools settings explained section by section: output folder, Dock and menu bar, readouts, appearance, history, alerts, AI assistants and helpers, with defaults.FFmpeg for Mac: install it for OneMacTools in one clickFFmpeg Mac install made simple: which OneMacTools video and audio tools need it, the one-click Homebrew install, using your own copy, and fixes when it fails.
Licence & privacy
Activate your OneMacTools licence key, move it and get helpActivate your OneMacTools licence key in a minute, move it to a new Mac, free a lost Mac online, find a lost key, and understand offline use and refunds.Mac app permissions: Full Disk Access, Screen Recording and what OneMacTools asks forEvery Mac app permission OneMacTools may ask for, from Full Disk Access to Screen Recording and Microphone: why, what breaks without it, and how to revoke it.
