Skip to main content
Glama
sommus-laptop

sommus-laptop

Sommus

CI

A personal assistant that controls my devices. Named after Somnus, the Roman god of sleep.

Type, text it on Telegram, or just talk to it: Sommus controls my MacBook, answers questions, and reaches my mail, notes and calendar. Next up: an always-on brain in the cloud, then speakers and custom hardware.

What a session looks like (illustrative):

you › study mode: close messages, open obsidian, volume 10
  → quit_app(name="Messages")
    ✓ Asked Messages to quit.
  → open_app(name="Obsidian")
    ✓ Opened Obsidian.
  → set_volume(level=10)
    ✓ Volume 10%.
sommus › Study mode is on: Messages closed, Obsidian open, volume at 10.
  4 steps · 9,812 in (7,904 cached) · 212 out · $0.0141

Measured, not guessed

Everyday commands (volume, apps, music, weather, "where's my next class")

$0, ~0.1 s, no model call

Commands that need the model

~0.5–1¢, 3–5 s (Sonnet 5, low effort)

Prompt tokens served from cache

89%

Class and room questions

20–27 s → under 1 ms (schedule engine instead of two calendar lookups)

Tool-call accuracy

45/46 on the eval suite (Sonnet 5); Haiku 4.5 41/46 at 0.26¢

Full numbers, regenerated from the log with sommus stats: docs/MEASUREMENTS.md. Why it's built this way: docs/decisions — MCP nodes, permission tiers and the PIN, the model sweep, no local LLM, one model with a budget guard instead of per-request routing, and the fast path.

Related MCP server: Apple MCP Server

What it can do

60+ tools across five nodes, plus live web search:

Area

Tools

Sound

volume, mute, play, pause, skip, what's playing

Display

brightness, screen off, lock

Apps

list open apps, open, quit, focus, any keyboard shortcut

Web & files

open a URL, Spotlight search, read a file or folder, append a line, open a file

Clipboard

read, write

Reminders

create (syncs to iPhone), list

Notes vault

search, read, append, add to the to-do list, commit

Email

search, read, send, reply, draft over IMAP/SMTP

System

battery, Wi-Fi status and toggle, sleep, notifications

Browser

list Chrome tabs, read a tab's text, list its links, click a link or button, switch tabs

Seeing & typing

screenshot (an image the model looks at), click at its coordinates, type any text, any keystroke, wait

Documents

read a PDF as text — scanned pages go through macOS Vision OCR

Contacts

look up anyone's number or email from the Contacts app

Downloads

fetch a file straight to disk, or save a logged-in page with Cmd+S

Messaging

send an iMessage, send or draft a Gmail

Escape hatch

run any of the user's macOS Shortcuts — Focus modes, Home devices, anything macOS won't script

Knowledge

web search for weather, news, prices, anything after the model's cutoff

It answers questions as readily as it acts, and when there's no exact tool it tries the nearest route (a Shortcut, a keystroke, opening the right settings pane) before saying it can't.

Without a model

  • Fast path (brain/fastpath.py): an intent claims a request only when every word is in its vocabulary — "brightness down 12", "screen's too dim", "quit Messages", "what's playing", weather and time anywhere, holidays, the to-do list. "A bit more" continues whichever level was just changed. A miss just goes to the model; a wrong match would do the wrong thing, so it leans towards missing.

  • Campus engine (brain/campus.py): next class, room, what's left today and what's due this week, from a schedule file. sommus today prints the day and writes data/today.json for other tools.

  • Long-term memory (brain/memory.py): "remember my gym days are Monday, Wednesday and Friday" is saved to a private note and loaded into the cached prompt. Anything that looks like a password or code is refused.

  • Budget guard (brain/budget.py): a heads-up at 80% of the monthly cap, a cheaper model past 90%.

Safety, in code

  • PIN gate (brain/pin.py): email, messages, files, the shell and Claude Code wait for a PIN said or typed; it never reaches the model or the log, and a PIN typed in Telegram is deleted from the chat.

  • Outside content can't act on its own (brain/loop.py): once a request has read mail, a web page, a PDF or the screen, sending, replying, the shell and Claude Code run only if the request itself asked for that — so text planted for an AI can't make it send anything (decision 7).

Nodes

Node

Tools

Setup

laptop

46 — sound, display, apps, browser, screen, shell, PDFs, contacts, files, clipboard, reminders, shortcuts

macOS permissions (below)

vault

9 — search, read by section, list, append, add a to-do, commit, remember, forget

none

gmail

6 — search, read, send, reply, draft, mark read

app password in .env

web

1 — search through a cheap worker model, so results never bloat the main context

API key

claude

1 — hands a request to Claude Code for Google Calendar, Drive and Notion

Claude Code installed

A node that isn't set up reports as unreachable; everything else keeps working.

Sommus on your phone (Telegram)

The brain doesn't change — Telegram is a second interface over the same event stream.

  1. Message @BotFather on Telegram, send /newbot, pick a name, copy the token.

  2. Put it in .env as TELEGRAM_BOT_TOKEN=... and leave TELEGRAM_ALLOWED_IDS empty for now.

  3. Start Sommus, message your bot once, and it prints your chat id:

sommus
  1. Put that id in TELEGRAM_ALLOWED_IDS and restart. Anyone not on that list is ignored and logged — without it, whoever finds the bot could drive the laptop.

Plain sommus answers the terminal and Telegram together, sharing one conversation — a lock keeps a phone command and a typed one from interleaving. /new starts fresh, /cost reports the day's spend.

Keeping it running

The terminal session stops when its window closes. For Telegram only, detached:

sommus start     # background, survives closing the window
sommus status    # is it alive, plus the last log lines
sommus stop

Not a LaunchAgent on purpose: macOS ties Accessibility and Automation permissions to the responsible app, which for a launchd job is the bare Python binary — every grant would have to be redone, and prompts would appear with nobody there to click them. Started from Terminal, the process inherits Terminal's grants for its whole life. After a reboot, run sommus start once.

The laptop still has to be awake: closing the lid pauses everything until it's opened.

Permissions, once

sommus permissions

Triggers every macOS prompt in one go — Accessibility, Screen Recording, Contacts, Reminders, Chrome, Chrome's JavaScript setting, Messages — while you're at the keyboard to approve them. Worth running before relying on the background service, since a prompt that appears while you're away silently blocks whatever it was doing.

Talking to Sommus (voice)

sommus voice     # always listening: say "Hey Sommus", then just talk. Return wakes it; typing works.
sommus voices    # hear the voices and pick one

Everything audio stays on the Mac, and none of it costs anything:

Step

How

Waking

Silero VAD cuts the mic into utterances (~1% of a CPU core); Whisper reads each one, and only one that starts or ends with "Sommus", "Hey Sommus", "What's up Sommus" or "Yo Sommus" wakes it. Nothing is kept or sent before that

End of turn

Smart Turn v3 (Pipecat, open source, ~55 ms on the CPU) judges from the tone of voice whether a sentence is finished: yes at a 0.4 s pause, and a pause to think gets up to 1.6 s

Conversation

Awake, everything said is a request — no wake phrase — until 30 s pass after a reply (90 s after a question), or "that's all". A small model checks that speech without the name was meant for Sommus, not someone else in the room

Interrupting

macOS echo cancellation keeps the mic open while Sommus talks; its name cuts it off ("Sommus, stop", or "Sommus, what about tomorrow?"), anything else — its own echo, the room — is ignored

Understanding

Whisper small.en on Apple silicon (mlx-whisper), ~0.4 s per command, offline, told the name up front so it spells it right from across a room

Speaking

Kokoro-82M on Apple silicon (mlx-audio), ~330 MB, offline. Sentences are voiced as the reply streams, so speech starts about 0.7 s after the first sentence arrives

Voice ID

WeSpeaker ResNet34 (VoxCeleb, CC BY 4.0) on onnxruntime, 26 MB, ~0.1 s per sentence. sommus voiceprint learns the owner's voice from 8 sentences; a request in that voice may use personal tools without the PIN, anyone else still needs it. Only the voiceprint's numbers are stored, never audio

Live mode (Gemini Live)

sommus live              # say "Hey Sommus", then talk like on a call: interrupt it, change your mind mid-sentence
sommus voices --gemini   # hear Gemini's voices; pick one in [live] voice, steer the accent with [live] style

Gemini Live hears and speaks in one model, so replies start in under a second (0.75 s measured) and it stops the moment you talk over it. It's free on an AI Studio key. Sommus still hears the wake word locally, runs every tool under its own rules (quick ones directly, the rest through the Claude brain as ask_sommus), and takes the PIN locally — the microphone stops going to Google until the digits are heard (decision 10).

Every utterance is logged to data/voice.log (loudness, detector score, transcript, and what was done with it), so when it misses something the log says which layer dropped it. Measurements behind these choices: decision 9.

Only the transcribed text reaches the model, so voice works unchanged wherever the brain runs. Replies play through the Mac's current output — AirPods included, even if they connect after Sommus starts. Set the voice in config.toml ([voice] kokoro_voice, speed); engine = "say" switches to the built-in macOS voice, which is also the automatic fallback if Kokoro can't load.

Connecting Gmail

Sommus talks to Gmail over IMAP and SMTP with an app password, not the Gmail API. Gmail's read scopes are "restricted", so a personal OAuth app can't leave Google's Testing mode without a security assessment — and tokens in Testing expire every 7 days. An app password never expires and needs no cloud project.

  1. Turn on 2-Step Verification on the Google account (required for app passwords).

  2. Go to myaccount.google.com/apppasswords, name it "Sommus", and copy the 16-character password.

  3. Put both in .env (gitignored):

GMAIL_ADDRESS=you@gmail.com
GMAIL_APP_PASSWORD=abcd efgh ijkl mnop

sommus check verifies the login. Without it, email still works through the browser (compose_email) and the Gmail tools just explain the setup.

Architecture

  INTERFACES                      BRAIN                         NODES
  ┌──────────────┐          ┌──────────────────────┐   MCP    ┌──────────────────┐
  │ terminal     │─ text ─► │ agent loop           │ ───────► │ laptop (macOS)   │
  │ telegram     │ ◄ events │ LLM API              │ ───────► │ vault (notes)    │
  │ voice        │          │ permission tiers     │ ───────► │ gmail            │
  └──────────────┘          │ audit log + cost     │          └──────────────────┘
                            └──────────────────────┘
  • Interfaces only exchange text and events with the brain. Voice is a new interface, not a rewrite.

  • Nodes are MCP servers. Each device lists its tools; the brain routes calls. A new device is a new node.

  • The agent loop is hand-written on the Messages API (src/sommus/brain/loop.py): streaming, adaptive thinking, prompt caching, refusal fallback, and a step limit.

Permission tiers

Sommus runs with full permission by default: it acts without asking. Every tool still declares a tier through MCP annotations, and every call is logged with its tier, so the gate can be switched back on ([safety] ask_before_destructive = true) when riskier tools arrive — email, files, voice.

Tier

Full permission (default)

ask_before_destructive = true

Examples

read

runs

runs

get_battery, list_apps, read_file

reversible

runs

runs

set_volume, open_app, press_keys, create_reminder

destructive

runs

asks y/N first

quit_app, sleep_computer, set_wifi

always_ask

asks every time

asks every time

unused today; for tools that should never run unattended

blocked

never runs, hidden from the model

same

set per tool in config.toml

A tool with no annotations counts as destructive.

run_shell exists after an experiment in going without it: with no shell tool, Sommus typed a command into Terminal with type_text instead — same power, no output, no exit code, no log, and it reported success for something that never ran. A real tool is the safer of the two. AppleScript still receives user text through argv, never string formatting, and every call is logged.

Setup

Needs macOS, Python 3.12, and uv (brew install uv).

uv sync
cp .env.example .env        # then paste your model API key into .env
uv run sommus check         # verifies the key, nodes, and macOS permissions
uv run sommus

To run it from any folder, add a shell function (this is what sommus means elsewhere in this README). --no-sync matters: without it uv re-checks dependencies over the network on every launch, and a dropped connection stops Sommus from starting. Run uv sync yourself after changing dependencies.

echo 'sommus() { uv run --no-sync --quiet --project "'"$PWD"'" sommus "$@"; }' >> ~/.zshrc

macOS Accessibility permission (for media_control, press_keys and lock_screen): System Settings → Privacy & Security → Accessibility → enable the terminal app you run Sommus from, then restart it. Reminders, Messages and Spotify/Music prompt separately the first time they're used (Privacy & Security → Automation). Screen Recording is needed for screenshot, and reading a Chrome tab's text needs Chrome's View → Developer → Allow JavaScript from Apple Events (titles and URLs work without it).

In the chat: /tools, /cost, /new, /quit. Ctrl+C cancels a reply.

Test a tool directly, no AI or API key needed:

uv run sommus tool                      # list tools
uv run sommus tool set_volume level=20
uv run sommus tool notify title=Hi message="From Sommus"

Use the laptop node from any MCP client

The node is a standard MCP server, so any MCP-capable app can use it without the brain. Point the client at:

command: .venv/bin/python
args:    -m sommus.nodes.laptop.server

Scoring it

evals/commands.toml holds the 20 commands Phase 1 has to handle. The runner replays each one in a fresh conversation and checks which tools were called:

uv run sommus eval                  # read tools run for real, the rest are simulated
uv run sommus eval --only volume    # just the commands mentioning "volume"
uv run sommus eval --live           # really run every tool (it will sleep the laptop)

Currently 46/46 on Sonnet 5 at low effort, ~$0.0095 per command. Target: never below 90%. Each run is saved to data/evals/ with the tools called, replies, latency and cost, so model and effort changes can be compared.

Layout

src/sommus/
├── brain/        loop.py · nodes.py · permissions.py · prompt.py · store.py
├── interfaces/   cli.py
├── evals/        runner.py
└── nodes/laptop/ server.py (MCP tools) · macos.py (system) · apps.py (music, Shortcuts, Reminders) · files.py
evals/commands.toml   the 20 commands Phase 1 must handle
tests/                agent loop + permission gate against a scripted fake model and a real in-process node

Development

uv run pytest
uv run ruff check src tests && uv run ruff format src tests

Every turn and tool call is logged to data/sommus.db (SQLite) with tokens and cost.

Available Tools

48 tools
append_to_fileA

Add a line to the end of a text file, creating the file if needed.

Args:
    path: Full path to the file.
    text: The line to append.

Inputs: path (required), text (required).

clickA

Click somewhere on screen, using coordinates from the most recent screenshot.

Args:
    x: Horizontal position in the screenshot.
    y: Vertical position in the screenshot.
    double: True for a double-click.

Inputs: x (required), y (required), double.

close_browser_tabsA

Close Chrome tabs. List them first, then pass the ones to close. Closed tabs come back with Cmd+Shift+T.

Args:
    tabs: Each a window.tab number ("1.4") or text from a title or URL ("Netflix"). Prefer numbers.

Inputs: tabs (required).

compose_emailA

Open a pre-filled Gmail draft in the browser for Jashan to look over. To send, use send_email.

Args:
    to: Recipient address.
    subject: Subject line.
    body: Message text.

Inputs: to (required), body (required), subject (required).

create_reminderA

Add a reminder in the Reminders app. Unlike a notification, this persists and syncs to the iPhone.

Args:
    title: What to be reminded about.
    due: Optional date and time as "2026-09-14 20:00". Omit for a reminder with no time.
    list_name: Optional Reminders list; omitted means the default list.

Inputs: title (required), due, list_name.

download_urlA

Download a file straight to disk. Works for public URLs; pages behind a login don't.

Args:
    url: Direct http(s) link to the file.
    folder: Where to save it (default ~/Downloads).
    filename: Optional name to save it as.

Inputs: url (required), folder, filename.

find_contactA
Read-only

Look up someone's phone number and email in Contacts. Use this before messaging or emailing a person.

Args:
    name: All or part of the name, e.g. "Kuljot", "didi", "mom".

Inputs: name (required).

find_filesB
Read-only

Search the Mac for files and folders by name (Spotlight).

Args:
    query: Part of the file name, e.g. "ECE 150", "resume", "lab 2".
    limit: How many results (default 10).
    folder: Optional folder to search inside, e.g. "~/Documents".

Inputs: query (required), limit, folder.

focus_browser_tabA

Bring a Chrome tab to the front.

Args:
    tab: Tab number, window.tab, or text from its title or URL.

Inputs: tab (required).

get_batteryA
Read-only

Get the MacBook's battery percentage, charging state, and time remaining.

Inputs: no named parameters.

get_brightnessA
Read-only

Get the built-in display's brightness as a percentage.

Inputs: no named parameters.

get_clipboardA
Read-only

Read what's currently on the clipboard.

Inputs: no named parameters.

get_now_playingA
Read-only

Get the track and artist currently playing in Spotify or Music.

Inputs: no named parameters.

get_volumeA
Read-only

Get the Mac's output volume (0-100) and whether sound is muted — also answers "is it loud".

Inputs: no named parameters.

get_wifiA
Read-only

Check whether Wi-Fi is on and which network the Mac is joined to.

Inputs: no named parameters.

list_appsA
Read-only

List the apps currently open (the ones shown in the Dock), which one is in front, and which can't be quit.

Inputs: no named parameters.

list_browser_tabsA
Read-only

List every open Chrome tab with its window.tab number, title and URL.

Inputs: no named parameters.

list_contactsA
Read-only

List everyone in the Contacts app with their numbers and emails.

Inputs: no named parameters.

list_embedded_filesA
Read-only

URLs of files embedded in a page (PDF viewers, iframes) — the real file behind a viewer.

LEARN shows PDFs inside a viewer, so saving the tab saves the wrapper page. Open the URL this
returns, then save that tab instead.

Args:
    tab: Tab number, window.tab, or text from its title or URL.

Inputs: tab (required).

list_remindersB
Read-only

List the user's unfinished reminders.

Args:
    limit: How many to return (default 10).

Inputs: limit.

list_shortcutsA
Read-only

List the macOS Shortcuts available to run. Use this to find capabilities Sommus has no tool for.

Inputs: no named parameters.

lock_screenA

Lock the screen immediately. Apps keep running; unlocking needs the password or Touch ID.

Inputs: no named parameters.

media_controlA

Play, pause or skip whatever is playing (Spotify, Music, YouTube in a browser...).

Args:
    action: "pause" and "play" do exactly that (use these when asked to pause, stop, play or resume);
        "play_pause" toggles; "next" and "previous" skip tracks.

Inputs: action (required).

notifyA

Show a macOS notification banner right now. For a reminder at a later time, use create_reminder.

Args:
    title: Short bold heading.
    message: Body text.

Inputs: title (required), message (required).

open_appA

Open an app, or bring it to the front if it's already running.

Args:
    name: The app's name as it appears in /Applications, e.g. "Spotify", "Google Chrome", "Notes".

Inputs: name (required).

open_fileB

Open a file or folder in its default app (Finder for folders, Preview for PDFs...).

Args:
    path: Full path to the file or folder.

Inputs: path (required).

open_urlB

Open a web page in the default browser.

Args:
    url: A full http:// or https:// URL.

Inputs: url (required).

press_keysA

Send a keyboard shortcut to an app — for actions with no dedicated tool.

Args:
    combo: Keys joined by "+", e.g. "cmd+s", "cmd+shift+t", "cmd+w", "escape", "left".
    app: App to bring to the front first, e.g. "Google Chrome". Recommended.

Inputs: combo (required), app.

quit_appA
Destructive

Quit a running app. The app may still ask to save unsaved work.

Args:
    name: The app's name, e.g. "Spotify". Use list_apps first if unsure of the exact name.

Inputs: name (required).

read_browser_tabB
Read-only

Read the visible text of a Chrome tab — the way to see what's on a page.

Args:
    tab: Tab number ("3"), window.tab ("1.3"), or text from its title or URL ("MATH 115").

Inputs: tab (required).

read_fileB
Read-only

Read a text file, or list a folder's contents. Long files are truncated.

Args:
    path: Full path, e.g. "~/Documents/notes.md".

Inputs: path (required).

read_pdfA
Read-only

Read a PDF as text, scanned ones included — far cheaper than screenshotting page by page.

Args:
    path: Path to the PDF, e.g. "~/Downloads/MATH117-L3-F26-Fong.pdf".
    pages: Which pages, e.g. "1-5", "3", "2,4,7". Omit for the whole file.
    ocr: Read scanned pages with OCR when they have no text layer (slower, ~3s a page).

Inputs: path (required), ocr, pages.

run_shellA
Destructive

Run a shell command and read its output. The way to do anything with no dedicated tool.

Commands run as Jashan from his home folder. sudo won't work — there's nobody to type a password.

Args:
    command: The command line, e.g. "ls ~/Downloads", "git -C ~/x status", "brew list | head".
    timeout: Seconds to allow before giving up (default 60).

Inputs: command (required), timeout.

run_shortcutA

Run one of the user's macOS Shortcuts. This covers things with no dedicated tool, such as Focus modes.

Args:
    name: The shortcut's name — call list_shortcuts first if unsure.

Inputs: name (required).

save_browser_tabA

Save a browser tab's file to disk (Cmd+S) — the way to get a PDF that sits behind a login.

Follow with read_pdf to read what was saved.

Args:
    tab: Tab number, window.tab, or text from its title or URL.
    folder: Where to save (default ~/Downloads).

Inputs: tab (required), folder.

screenshotA
Read-only

Take a screenshot and look at it. Use this to see an app's state, then click what you see.

Click coordinates refer to this image.

Inputs: no named parameters.

send_messageA
Destructive

Send an iMessage. This reaches another person and can't be unsent.

Args:
    to: Phone number or Apple ID — look it up with find_contact when given a name.
    text: The message body.

Inputs: to (required), text (required).

set_brightnessA

Set the built-in display's brightness (external monitors aren't supported).

Args:
    level: Brightness from 0 (darkest) to 100 (brightest).

Inputs: level (required).

set_clipboardC

Put text on the clipboard, ready to paste.

Args:
    text: The text to copy.

Inputs: text (required).

set_muteA

Mute or unmute sound output without changing the volume level.

Args:
    muted: True to mute, False to unmute.

Inputs: muted (required).

set_volumeA

Set the output volume and unmute.

Args:
    level: Volume from 0 (silent) to 100 (maximum).

Inputs: level (required).

set_wifiA
Destructive

Turn Wi-Fi on or off. Turning it off cuts the internet, including Sommus's own connection.

Args:
    on: True to turn Wi-Fi on, False to turn it off.

Inputs: on (required).

sleep_computerA
Destructive

Put the whole MacBook to sleep. Sommus stops responding until the lid is opened or a key is pressed.

Inputs: no named parameters.

sleep_displayA

Turn the display off. Apps and downloads keep running.

Inputs: no named parameters.

type_textA

Type text into an app — for writing into a document, a form, a chat box.

Keystrokes go to whatever is in front, so pass `app` (or focus it first) when the text is meant
for a particular one. Don't use this to run shell commands; use run_shell, which returns output.

Args:
    text: The literal text to type.
    press_return: True to press Return afterwards (submits the line).
    app: App to bring to the front first, e.g. "Google Chrome", "Notes". Strongly recommended.

Inputs: text (required), app, press_return.

waitA
Read-only

Pause before the next step — for pages, apps or downloads that need a moment.

Args:
    seconds: How long to wait, up to 10.

Inputs: seconds (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 48 tools

    Disambiguation4/5

    Most tools target a clearly distinct resource+action (battery, volume, brightness, wifi, clipboard, apps), and descriptions proactively disambiguate tricky pairs like notify vs create_reminder, sleep_display vs sleep_computer, and type_text vs run_shell. A few pairs remain close (click vs click_page_link, save_browser_tab vs download_url vs list_embedded_files, list_page_links vs read_browser_tab), but the guidance largely resolves them.

    Naming Consistency4/5

    The set sticks mostly to a verbose verb_noun pattern (get_battery, set_volume, list_apps, create_reminder, read_browser_tab), which is highly predictable. Minor deviations exist: bare verbs (notify, click, wait, screenshot), one noun_verb (media_control), and slightly inconsistent qualifiers (page vs browser_tab for the same concept).

    Tool Count2/5

    At 48 tools this is a very heavy surface, well beyond the 15-25 range that already feels crowded, even accounting for the broad macOS-automation domain spanning browser, files, system, media, contacts and messaging. Individual tools are mostly justified, but the sheer count raises selection cost and overlap risk.

    Completeness4/5

    Coverage is broad and self-aware, with escape hatches (run_shell, run_shortcut, press_keys) for anything lacking a dedicated tool, and files/reminders/system state reasonably covered. Gaps remain: compose_email references a nonexistent send_email, and reminders/contacts/messages lack full update-delete lifecycle coverage.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Enables AI assistants to automate macOS through AppleScript and JXA by providing 44 tools for application management, window control, and UI interaction. It allows for comprehensive system control including screen capture, keyboard and mouse simulation, and system information retrieval.
      44
      15 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude to automate macOS applications, manage files, control music, send messages, and more through AppleScript.
      29 npm
      1
      GPL 3.0