Japanese Translation:

Atticus は、macOS の自動化において画期的な存在として、機密性とオープンソースのユーティリティを提供し、オペレーティングシステムを瞬時に制御しつつ、ローカルのプライバシーと安全性を最優先しています。一部のツールが各タスクに対してクラウド処理に依存するのみであるのに対し、Atticus は安全なローカルサンドボックスとして機能し、ウィンドウの移動、コマンドの実行、ファイル管理、画面読み取り、Mac エコシステム全体へのアクセス（Peekaboo を介したアプリケーション内部でのクリック操作を含む）を直接デバイス上で実行することができます。このアプリケーションは驚異的な速度を達成しており、アプリを開くのにわずか 0.08 秒仅需え、学習されたショートカットを利用することでタスク時間を 5 秒以上から 0.4 秒まで短縮します。重要なのは、安全性を最優先し、コマンドを実行するサンドボックス内で実行し、

sudo

、

rm

、シャットダウンなど危険なアクションをユーザーの確認なしで自動的にブロックすることで、偶発的なシステム障害を防ぐことです。データプライバシーは、Apple のオンデバイスでの音声変換を通じて確保されており、音声が Mac を離れることはありません。インストールには特定の前提条件（Xcode のセットアップを含む）が必要であり、AI 処理には既存の有料 Claude プランに依存します（約 $0.14¢/query）。しかし、このモデルは従来のクラウド中心のツールと比較して運用コストを大幅に削減し、使用中の平均費用は極めて低く抑えられています（$0.002 未満）。ソースコードは MIT ライセンスされており、開発者にとって透明性を保証しています。

Atticus: 音声指令で制御する macOS の AI エージェント

Control キー（⌃）、Command キー（⌘）、Option キー（⌥）を同時に押しながら、必要な操作を口述してください。 手を離すと Atticus が動作を開始し、ウィンドウ配置、ファイル探索、画面理解など、あなたの要望を実現します。

✨ 主な特徴

高速処理: AI を介さない仕組みで、アプリ起動までの時間が 0.08 秒 と驚くほど短いです。
- 一度指示すれば学習され、次回以降は AI を通さず、無料で即座に動作します。
API キー不要: クロード Pro または Max プランをお持ちであれば、既存のプラン（Claude Code 経由）を利用できます。
- 登録作業、キーのコピー貼り付け、追加料金は一切不要です。
ユーザーごとに記憶する: 「remember ～」と指示すると、その後のすべてのリクエストで情報を承知したまま処理されます。
- 名前や使用するアプリなどを把握し、訂正内容を学習して自身のミスを修正します。

💬 自然な問いかけだけで動作させよう

「あなたが言うこと」 → 「Atticus が行うこと」:

「大きな画面にコードを開いて。ノートパソコンには Chrome とターミナル。」
- 2 つのディスプレイにわたって 3 つのウィンドウを配置します。
「Spotify を開く」／「ターミナルを左側に置く」
- AI を一切使わず、瞬時に実行されます。
「東京旅行についてのメモを探して。」
- ファイルの中身を検索し、見つかったものを別の画面で開きます。
「このコードの不具合は何だろう？」
- あなたの画面を確認し、一行の文章で回答します。
「この記事を要点を 3 つにまとめて。」
- ページを読み込んで要約を行います。
「返信：それいいね、7 時に会おう。」
- 現在使用中のアプリに入力します（送信は行われません）。
「夜間のコーディングプレイリストを Spotify で再生して。」
- クリックすることなく瞬間に再生されます。
「focus mode と言うと、Slack を閉じてタスクリストを開いて」
- 学習して保存され、次回以降は 2 つの単語だけで完結します。

🚀 なぜ Atticus か？

圧倒的な速度: アプリ起動やウィンドウ移動などは AI を一切介しません（アプリ起動は 0.08 秒）。
- 一度指示した操作は「学習されたショートカット」として保存されます。
- 例：「電卓とチェスを開いて」のコマンドは、AI を通す場合が 5.5 秒だったが、AI を通さない状態で 0.4 秒に短縮されました。
コスト効率:
```
claude -p
```
を介して既存のプラン上で動作します。
- 1 クエリあたり約 0.14 セント（API リスト時のレート換算）がかかりますが、Atticus ソフトウェア自体は無料です。
永続的な学習: 「remember: open means bring to front」のような保存ルールは維持されます。
- 名前や住んでいる都市など、永続的な事象を学習します。訂正すれば次回以降正確に動作し、「設定（Settings）」画面から編集可能です。
プライバシー重視: Apple のオンデバイス搭載機能により、声は Mac から外部には送信されず、ローカルでテキストに変換されます。
完全管理: アプリ、ウィンドウ、ファイル、設定、ウェブページ、画面内容まで制御可能（Peekaboo 機能を備えているため、任意のアプリ内部をクリックできます）。
デフォルトでの安全性: セーフモードでは、AI のコマンドは Claude Code のサンドボックス環境内で実行され、書き込み権限は一時フォルダにのみ与えられます。
- ファイルの削除、送信、購入、変更などはユーザーの確認を求めます。
- ```
rm
```
  コマンドや
```
sudo
```
  命令、ディスク管理ツール、シャットダウンなどは常にブロックされます。
- すべての正確なコマンドは「問い合わせログ」に記録されます。

🛠️ ショートカットとボックスの仕組み

操作モード

Hold（押したまま）: 離すと送信します。
Press（押す）: トグル機能です（1 回目は開始、2 回目で送信；一時停止中はリスニング継続）。
- Atticus が回答中にショートカットを押すと処理が停止し、音声再生中なら音声も停止します。
キャンセル:
```
Esc
```
キーでリスニングをキャンセルしますが、送信はありません。
自動確認: トグル録音機能は 60 秒後にレビュー画面を表示し、自動送信せず確認を求めます。

コマンド実行

即時実行: オーバーレイを閉じたり Atticus を一時停止したりすると、マイク・ワーカー・音声処理がすべて止まります。
安全確認: Apple の最終的なトランスクリプトにより、AI ツールや学習されたショートカットが実行される前に、声によるリクエスト内容が必ず確認されます。
半途中の実行: 送信前でも、「Act while I'm talking」や「Instant commands」機能を有効にすれば、文の途中で実行可能です。

インタラクション

クリックでコピー：表示された回答をコピーできます（過去の回答も対象）。
リクエスト編集：自分のリクエストをクリックして編集し、再度問いかけ直すことができます。
履歴呼び出し：空の入力ボックスで
```
↑
```
キーを押すと最新のリクエストを呼び出せます。
オーバーレイ動作: リサイズしても画面外に出ず、「動きの軽減」設定にも準拠しています。

📥 インストール

環境要件

macOS 26 以降: Atticus は Apple の新しいオンデバイス音声認識機能を使用するため必須です。
Claude Pro または Max プラン: クロード Code がインストールされている必要があります（セットアップウィンドウが自動導入）。
Xcode コマンドラインツール:
```
xcode-select --install
```
を実行してください。

インストール手順

ターミナルに以下のコードを貼り付けて実行してください:

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

このスクリプトは Mac 環境を確認し、Atticus を
```
~/.atticus
```
にダウンロードします。
```
~/Applications/Atticus.app
```
を構築し、自動的に起動します。
自動起動: ログイン時に自動起動し、フォルダからアップデートも適用されます（設定 → 情報とアップデートでオフに可）。
開発用: リポジトリをクローンし、変更ごとに
```
./build.sh
```
を実行してください。

初回起動と設定

セットアップウィンドウが開きます。Claude プランの確認後、macOS パーミッション許可を行ってください。
メニューバーに存在します。Spotlight（⌘Space + "Atticus"）から開き、以下を設定可能です：
- ショートカット、サウンド、モデル、速度
- 画面表示、メモリ使用量、利用状況

注: Claude からサインアウトするとセットアップウィンドウが再出現します。再度表示するには以下のコマンドを実行してください。
defaults delete com.atticus.app onboarded
アプリ再起動を行ってください。

🧪 テスト方法

macOS での自己テスト:

python3 atticus.py --selftest

オフライン回帰テスト:

python3 -m unittest discover -s tests -v

ネイティブトランスクリプト一致確認（アプリ起動時）:

~/Applications/Atticus.app/Contents/MacOS/Atticus --selftest

JavaScript 構文確認 (Node がインストールされている場合)

UI 相互作用テスト:

python3 -m http.server 8765 --bind 127.0.0.1

ブラウザで

http://127.0.0.1:8765/tests/ui.html

を開いてください（疑似的なネイティブブリッジを使用）。

🗑️ アンインストール（リムーバル）

以下のコマンドを実行し、関連ファイルを削除してください:

launchctl bootout gui/$(id -u)/com.atticus.app
rm ~/Applications/Atticus.app
rm -rf ~/.atticus
rm -rf ~/.config/atticus
rm ~/Library/LaunchAgents/com.atticus.app.plist

📟 ウォッチモード（監視機能）

「tell me when Codex is done」または「watch this page until it says shipped」 と口述してください。

一度設定されると、Mac で 5 秒間隔で確認を続けます（AI を使わず、無料）。
完了すると通知を受け取れ、フォローアップタスクを実行します。
デスクトップにはウィンドウを表示せず、カバーしていても問題ありません。
「stop watching」 と口述して停止を指示してください。

💰 予算制約

Atticus は常に高速でほぼ無料であることを優先しています:

瞬時コマンド: AI を使用せず、費用は $0 です。
AI による問い合わせ:
- 直近 50 件の平均では $0.002 未満。
- 処理時間は 6 秒以内（現状：5.0 秒）。
- 確認には
```
python3 atticus.py --budget
```
  を使用してください。
システムプロンプト: オプション全有効時でも 10,000 キャラクター以内に収めます。テストで強制されます。
バックグラウンドタスク: 待機中は $0 です（AI はセットアップ時と最終アクション時のみ使用）。

🔢 ユーザー数のカウント

Atticus は毎日、一度だけ PostHog にランダムな ID を送信し、利用者数を把握します。

送信内容: 名前、問い合わせ内容、画面表示内容は一切送信しません。
オフにする方法: 設定 → アカウントとアクセス → 「me as a user」をオフにしてください。

📂 ファイル構成

ファイル	説明
`Atticus.swift`	アプリ本体（ホットキー、音声認識、オーバーレイ）
`atticus.py`	中枢処理部（高速コマンド、システムプロンプト）
`ui/ui.html`	オーバーレイ画面
`ui/onboarding.html`	ウェルカムフロー画面
`ui/settings.html`	設定画面
`ui/AppIcon.icns`	アプリのアイコン
`ui/orbs.js`	思考オーブエンジン（MIT ライセンス）

📜 ライセンス

MIT ライセンス
- 詳細は
```
LICENSE
```
  ファイル参照。
- 「ui/orbs.js」も thinking-orbs プロジェクトより MIT ライセンスで入手可能です。

🤝 コントリビュート（貢献）

テスト環境: 回帰テストには
```
ATTICUS_DIR
```
を指定したクリーンな環境を使用してください。UI チェックには
```
tests/ui.html
```
と
```
tests/settings.html
```
の疑似ブリッジを使用してください。
コミット時の注意事項:
- 個人のエージェント設定、認証情報、ランタイムステートを含まないようにしてください。
トラッキング: 匿名利用トラッキングは、環境変数に
```
ATTICUS_POSTHOG_KEY
```
が設定されていない限り無効化されており、ソースコード内にキーは埋め込まれていません。

Show HN：Atticus – Claude-p で動作する macOS の「話し続けるためのボイスアシスタント」