Repolode
Submit
SaarthurR

SaarthurR/atticus-mac

A macOS voice assistant that runs on your existing Claude Pro or Max plan through Claude Code, with no API key needed.

View on GitHubWebsite
Stars
212
Forks
11
Open issues
2
Last commit
2 days ago

What is it?

Atticus is a voice assistant for macOS. You hold Control, Option and Space, say what you need, and release. It can move windows, open apps, find files by their contents, read the screen, and carry out multi-step tasks in the background. Simple requests such as opening an app or moving a window run without calling AI, and actions you request repeatedly are saved as shortcuts that run without AI on later uses.

Atticus uses your Claude Pro or Max plan through Claude Code, or a Devin plan through the Devin CLI, so no separate API key is required. Speech is converted to text by Apple's on-device recognition, and it can also be pointed at a custom server such as Ollama or LM Studio. It requires macOS 26 or later.

The app includes a remembered-rules system that stores facts and corrections for future requests, a safe mode that restricts the AI to a scratch folder and asks before deleting, sending or purchasing, and optional meeting transcription with a local archive.

Key features

  • 01Hold a shortcut to speak, and Atticus moves windows, opens apps and plays music.
  • 02Runs on an existing Claude Pro or Max plan through Claude Code, with no API key.
  • 03Searches files by their contents and opens the match.
  • 04Reads the screen and can point to UI elements or type into apps via Accessibility.
  • 05Saves repeated actions as shortcuts that run without AI.
  • 06Safe mode sandboxes AI commands and asks before destructive actions.

Use cases

  • Arranging windows across multiple displays by voice.
  • Finding local documents by remembering what they contain.
  • Asking questions about what is on screen while working.
  • Delegating longer tasks to a background agent and getting notified when done.

Quick start

  1. 1

    Install Apple's command line tools

    xcode-select --install
  2. 2

    Paste the installer command in Terminal

    curl -fsSL https://raw.githubusercontent.com/SaarthurR/atticus-mac/main/install.sh | bash
  3. 3

    Follow the setup window on first launch to check your AI plan and grant macOS permissions

Things to know

  • macOS 26 or later only.
  • Needs a paid Claude Pro or Max plan with Claude Code, or a Devin plan.
  • Requires several macOS permissions, including Accessibility, to control your Mac.

Topics

#voice-assistant#macos#claude-code#speech-recognition#productivity#automation#claude#menubar-app#open-source#swift

FAQ

What is atticus-mac?
A macOS voice assistant that runs on your existing Claude Pro or Max plan through Claude Code, with no API key needed. Atticus is a voice assistant for macOS. You hold Control, Option and Space, say what you need, and release. It can move windows, open apps, find files by their contents, read the screen, and carry out multi-step tasks in the background. Simple requests such as opening an app or moving a window run without calling AI, and actions you request repeatedly are saved as shortcuts that run without AI on later uses.
Is atticus-mac free to use? What license does it have?
atticus-mac is open source under the MIT license. Check the license terms before using it in commercial products.
Is atticus-mac still maintained?
Actively maintained. The last commit to atticus-mac was on Oct 17, 2026.
What can I use atticus-mac for?
Arranging windows across multiple displays by voice. Finding local documents by remembering what they contain. Asking questions about what is on screen while working. Delegating longer tasks to a background agent and getting notified when done.
How do I install atticus-mac?
Install Apple's command line tools: xcode-select --install Paste the installer command in Terminal: curl -fsSL https://raw.githubusercontent.com/SaarthurR/atticus-mac/main/install.sh | bash Follow the setup window on first launch to check your AI plan and grant macOS permissions
Where can I get atticus-mac?
The source code and installation instructions are on GitHub: https://github.com/SaarthurR/atticus-mac

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects