Threats & Malware
Scan, quarantine, restore, and manage exclusions — with up-to-date malware signatures.
14 tools — 9 read-only, 5 that always ask your approval first.
Read-only tools never modify anything; anything that changes your Mac pauses on an Approve card first.
run_malware_scan Read-onlyScan this Mac for malware and threats. Returns the actual detected items — each with its name, file path, category, and why it was flagged — split into real threats (real_threats) vs calm likely-legitimate background items (background_items, e.g. signed login items / browser extensions), plus counts and the overall level. Always list the specific real threats with their files/paths so the user can decide.
forensic_scan Read-onlyRun a forensic scan for leftover traces (metadata leaks, keychain artifacts, stealth headers) and return a 0-100 forensic score.
quarantine_threats Asks firstMove the real malware threats found by a scan into secure quarantine (calm likely-legitimate background items are left alone).
list_quarantined_items Read-onlyList the items currently held in Cyclone's malware quarantine — each with its name, original location, threat category/level, size, and when it was quarantined.
restore_quarantined_item Asks firstRestore one item from Cyclone's quarantine back to its original location (the undo of quarantine — e.g. for a false positive). Provide the item's name from list_quarantined_items. Only suggest this when the user is confident the item is safe.
exclude_threat Asks firstExclude a detected item from future malware scans so Cyclone stops flagging it (for items the user knows are safe, e.g. their own script). The item must appear in this conversation's most recent scan results — run run_malware_scan first.
list_threat_exclusions Read-onlyList the items the user has excluded from malware scans (the scan ignore-list), each with its path and when it was excluded.
remove_threat_exclusion Asks firstRemove an item from the malware-scan exclusion list so future scans flag it again (the undo of exclude_threat). Provide the name or path from list_threat_exclusions.
check_signature_status Read-onlyReport whether Cyclone's own malware-signature database is up to date: the installed signature version, when updates were last checked, and (when online) a live freshness check against the update server. Never reveals signature counts.
list_recent_downloads Read-onlyList the newest items in the Downloads folder with size, date, and whether macOS still marks them quarantined (unverified).
check_xprotect_version Read-onlyReport the versions of macOS's built-in malware defenses (XProtect, mrt, Gatekeeper data) — read locally, no network.
get_antivirus_check_status Read-onlyReport the state of Antivirus Check — Cyclone's watcher (on by default on new installs) that runs each new file through the same detection engines as a Deep Scan, for as long as Cyclone is running, including when only its menu-bar icon is showing. Returns whether it is enabled and actually watching, the active scope (Downloads and the folders directly inside it / internet arrivals anywhere / every new program anywhere apart from macOS's own temporary and cache folders), the files checked this session, how many arrived while Cyclone was closed, any live detections and any running-program advisories. It cannot read a program's memory.
set_antivirus_check Asks firstTurn Antivirus Check on or off, and optionally set how much it watches. On means: for as long as Cyclone is running (the menu-bar icon counts; quitting stops it), every new file arriving in the chosen scope is checked with the same engines as a Deep Scan, and detections appear in the Antivirus/Malware Scanner panel with a Quarantine button. The scope is the Downloads folder and the folders directly inside it (the default), anything arriving from the internet anywhere on the Mac, or every new program anywhere apart from macOS's own temporary and cache folders — wider scopes add to the Downloads cover, never reduce it.
check_running_programs Read-onlyCheck every program running right now: examines the file each one was launched from with the same engines as a Deep Scan, and flags a program running from a deleted file or with an extra library forced into it. Not a memory scan — macOS does not allow reading another program's memory — and advisories are presented as things to judge, since both signals have innocent causes.