mk668a/GhostType has 38 GitHub stars and 2 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 03:09 UTC. Last push 2026-08-11.
計測したスター増加
- 24時間
- 0
- 7日間
- 履歴を収集中
- 15日間
- 履歴を収集中
- 1か月
- 履歴を収集中
期間ごとの純増数です。期間は重複しており、日別の値ではありません。未計測の値は空欄です。スター数は注目度の指標であり、品質の保証ではありません。
概要
AI-powered keyboard completion engine for macOS
開発ツールdocs/i18n/README.ja.md
オリジナル
English · 日本語 · 简体中文 · 繁體中文 · 한국어 · Español · Français · Deutsch · Português
GhostType
Macのあらゆるテキスト欄で、Tabキーひとつで続きが書ける。しかも全部あなたのMacの中で動く。
GhostTypeは、クローズドソースのMac用補完アプリCotypistの、MITライセンスによる無料の代替です。
こういう場面のために
Gmailで返信を3文ほど書いたところ。この文がどう終わるかは、もう頭の中にある。それでも全部打たないといけない。
エディタはこの問題を何年も前に解決しました。GitHub Copilotが行の続きをグレーで見せてくれて、Tabキーを押すだけ。ところがメールにもSlackにもメモにも、そして実際に一日の大半を費やしているブラウザの入力欄にも、それがありません。
GhostTypeがすること
打つ手を止めると、カーソル位置にグレーの文字が出ます。Tabキーを押します。
Before: Thanks for sending over the draft. I read through it this morning and I think▌
After: Thanks for sending over the draft. I read through it this morning and I think
it's great. I'm going to start working on it today.▌
└─ grey ghost text, Tab to accept, Esc to dismiss
これは同梱モデルが実際に返した補完です。Safari、メモ、メール、Slack、その他どのテキスト欄でも同じように動きます。
Gmailで返信を書く
Xに投稿を書く
動かし方は2通り
ローカルAI系のMacアプリの多くがここを外しています。モデルを同梱するので、すでに自分でモデルを動かしている人は、同じ重みがメモリ上に2つ載ることになる。GhostTypeは選ばせます。
| 内蔵 | 外部サーバー | |
|---|---|---|
| 準備 | 設定画面でモデルをダウンロードするだけ。他に入れるものなし。 | すでに動かしているサーバーを指定するだけ。 |
| 実体 | アプリに同梱したllama-server |
LM Studio、Ollama、llama.cpp、vLLM、LocalAI |
| メモリ上のモデル | GhostTypeが読み込む1つ | 追加ゼロ。すでに載っているものを使う。 |
| 向いている人 | 「とにかく動いてほしい」 | 「32Bをもう動かしてるからそれを使え」 |
どちらも最終的には同じOpenAI互換のHTTPエンドポイントに行き着くので、2つの別物を貼り合わせたつくりにはなっていません。違うのはサーバープロセスを誰が持つかだけです。
外部サーバーがllama-serverだった場合、GhostTypeはそれを自動で判別し、内蔵バックエンドと同じ高品質な補完経路を使います。詳しくは補完の品質を参照してください。
インストール
Releasesから最新の.dmgをダウンロードし、開いてGhostTypeをアプリケーションにドラッグします。
初回起動時の許可
GhostTypeはnotarize(Appleの公証)を受けていません。公証には有料のApple Developerアカウントが必要で、このプロジェクトは持っていないためです。そのためmacOSが初回起動をブロックし、手動での許可を求めます。1回だけの作業です。
- GhostTypeを開く。macOSが「開発元を確認できません」と拒否します
- システム設定 > プライバシーとセキュリティを開き、下方のセキュリティまで進む
- GhostTypeがブロックされた旨のメッセージの横でこのまま開くをクリックし、確認ダイアログで開く
macOS 15 Sequoia以降では、アプリを右クリックして開くを選ぶ方法は使えません。Appleがこのショートカットを削除したため、システム設定からの許可が唯一の経路です。
GhostType自身が後から適用するアップデートでは、この手順は繰り返されません。この確認はダウンロードしたアプリの初回起動にだけ適用され、その場で更新されるアプリには適用されないためです。
この手順を丸ごと省きたい場合は自分でビルドしてください。自分でコンパイルしたアプリはダウンロードされたものではないので隔離フラグが付かず、警告なしで起動します。
セットアップ
手順1: バックエンドを選ぶ
初回起動時にセットアップガイドが開きます。内蔵を選んでモデルをダウンロードするか、外部サーバーを選んでエンドポイントを入力します。
内蔵モデル。文章用にはチャット向けの指示調整版ではなくベースモデルを採用しています。チャットモデルに文の続きを頼むと、続きを書かずに返事をしてしまうためです。
| モデル | サイズ | 用途 | 備考 |
|---|---|---|---|
| Qwen3.5 0.8B Base | 約0.6GB | 文章 | 最速。メモリ8GBのMacでも快適。 |
| Qwen3.5 2B Base | 約1.3GB | 文章 | 推奨。速度と品質のバランスが最良。 |
| Qwen3.5 4B Base | 約2.7GB | 文章 | 品質重視。メモリ16GB以上向け。 |
| Qwen2.5-Coder 0.5B | 約0.5GB | コード | 軽量。コードや技術文書向け。 |
| Qwen2.5-Coder 1.5B | 約1.6GB | コード | コードに強く、日常の文章には弱い。 |
モデルは~/Library/Application Support/GhostType/modelsに保存され、Macの外に出ることはありません。
手順2: 2つの権限を許可する
GhostTypeには両方が必要です。
- 入力監視: 打鍵が止まったことを検知するため
- アクセシビリティ: カーソル周辺の文章を読み、確定した補完を挿入するため
システム設定 > プライバシーとセキュリティでそれぞれ有効にします。どちらが足りていないかはメニューバーのアイコンが教えてくれます。
手順3: 何か打ってみる
テキストエディットを開いて文を半分だけ書き、少し待ちます。グレーの文字が出たらTabキーです。
補完の品質
採用したくなる補完と、消したくなる補完を分けるのは、次の2点です。
Fill-in-the-middle(前後を見た補完)。 多くの補完ツールはカーソルより前の文章しかモデルに渡しません。モデルは文の続きがすでに存在することを知らないまま書くので、すでにある結びの上にもう一つ結びを書いてしまいます。GhostTypeはllama.cppの/infillエンドポイントを使って前後両方を渡すため、補完が文の末尾を重複させず、文の「中」に収まります。
制約付き生成。 文の続きを頼まれたモデルは、ときどきコードフェンスで囲んだり、元の文を引用し直したり、3段落の解説を書いたりします。それを後から取り除くのは当て推量です。GhostTypeはGBNF文法を組み立ててサンプラーに渡し、そうしたトークンをそもそも選べなくします。捨てる前提の文章を生成する時間自体が発生しません。
| 設定 | 文法 | 使いどころ |
|---|---|---|
| 1行 | 改行と行頭のコードフェンスを禁止 | メール、チャット、ブラウザの入力欄(既定) |
| 数行まで | 最大4行まで許可 | エディタ、メモ、複数行の入力欄 |
| 制約なし | なし | 制約下でモデルの挙動がおかしいとき |
どちらの機能もllama.cppのAPIを話すサーバーが前提です。内蔵バックエンドでは常に成立し、外部のllama-serverでも成立します。それ以外のOpenAI互換サーバーに対しては、カーソル位置を印で示すチャット補完に切り替わります。動きはしますが、切れ味は明らかに落ちます。
キーボードショートカット
| キー | 動作 |
|---|---|
Tab |
補完を確定 |
Esc |
補完を消す |
Cmd + Option + \ |
手動で補完を呼ぶ |
Cmd + Shift + G |
GhostTypeのオン/オフ |
すべて設定画面で変更できます。
アプリごとの対応状況
| アプリの種類 | 自動補完 | 理由 |
|---|---|---|
| テキストエディット、メモ、Pages | 対応 | アクセシビリティAPIに完全対応 |
| Safari、Chromeの入力欄 | 対応 | 打鍵バッファで代替 |
| メール、Slack、Discord | 手動のみ | 自動補完がアプリ側の入力処理と競合する |
| IDE、ターミナル | 無効 | 元から補完機能がある |
日本語、中国語、韓国語などの入力メソッドが変換中のあいだは自動補完が止まるので、変換の邪魔をすることはありません。
やらないこと
- クラウド推論をしません。APIキーの入力欄がないのは、キーを入れる先のAPIが存在しないからです。
- テレメトリも解析も入力ログも取りません。
- アカウント登録も、サブスクリプションも、利用回数の上限もありません。
- 文章の書き換え、翻訳、再構成はしません。書き始めた文を最後まで書くだけです。
動作環境
| 最低 | 推奨 | |
|---|---|---|
| macOS | 14.0 Sonoma | 15.0 Sequoia |
| チップ | Apple M1 | Apple M2 Pro以上 |
| メモリ | 8GB | 16GB以上 |
| ストレージ | 1GB+モデル分 | 5GB |
プライバシー
補完はすべてMacの中で生成されます。内蔵バックエンドは127.0.0.1上のllama-serverプロセスと通信し、外部バックエンドは指定したループバックアドレスと通信します。GhostType自身のアップデート確認以外に、ネットワーク通信は発生しません。
うまく動かないとき
システム設定ではオンになっているのに、GhostTypeが「権限がない」と言う。 0.3.1以前から更新した人は全員これに当たります。macOSはアクセシビリティの許可を、それを受け取ったアプリのコード署名に結びつけて保存します。0.3.1までの各リリースはビルドごとに変わるハッシュで署名されていたため、バージョンが変わるたびに署名も変わっていました。1.0.0からは固定の証明書で署名するのでここで打ち止めですが、あなたのMacには古い規則が残ったままです。設定画面のスイッチは許可の値を変えるだけで、そこに紐づく規則を書き直しません。だからスイッチはオンに見えるのに、アプリは拒否され続けます。
スイッチをオフにしてオンに戻しても消えません。マイナスボタンで一覧からGhostTypeを削除しても消えません。保存された項目そのものを削除する必要があります。
sudo tccutil reset Accessibility com.ghosttype.app
sudo tccutil reset ListenEvent com.ghosttype.app
sudo killall tccd
そのあとGhostTypeを起動し直し、求められたら承認してください。必要なのは一度だけです。自分がこの症状かどうかは、次のログにFailed to match existing code requirementが出るかで判別できます。
log show --last 5m --predicate 'process == "tccd"' | grep -i ghosttype
他のアプリで補完が出ない。
メニューバーの状態を見てください。「アクセシビリティを許可」または「入力監視を許可」と出ていたら、システム設定の該当ペインでGhostTypeをオンにします。数秒で自動的に再起動します。ソースからビルドすると署名し直されるため、署名IDを指定せずにビルドすると毎回署名が変わり、ビルドのたびにアクセシビリティの再許可を求められます。scripts/make-signing-cert.shを一度実行し、GHOSTTYPE_SIGN_IDENTITYを設定してビルドすれば、再ビルドしても許可が残ります。
設定画面のテスト欄では出るのに、他では出ない。 アクセシビリティ権限だけが足りていません。テスト欄はGhostType自身の中にあるため、システム権限を必要としません。
状態は「Ready」なのにグレーの文字が出ない。 内蔵ならモデルがダウンロード済みか、外部ならサーバーが動いているかを確認してください。手動ショートカットも試し、除外アプリ一覧に入っていないかも見てください。
内蔵バックエンドが「llama.cppのバイナリがない」と言う。
バイナリを含めずにビルドされたものを動かしています。scripts/fetch-llama.shを実行して再ビルドするか、外部サーバーに切り替えてください。
ソースからビルドする
git clone https://github.com/mk668a/GhostType.git
cd GhostType
open GhostType.xcodeproj
ビルドは初回にllama.cppの固定バージョンのリリースバイナリを取得し、アプリバンドルに配置します。別途の準備は不要です。手動で取得する場合や、Intel向けにビルドする場合は次のとおりです。
./scripts/fetch-llama.sh # host architecture
LLAMA_ARCH=x64 ./scripts/fetch-llama.sh # Intel
GHOSTTYPE_SKIP_LLAMA=1 xcodebuild ... # skip, external backend only
その他のスクリプト:
./scripts/create-dmg.sh # build the DMG installer
./scripts/install.sh # build and install into /Applications
Xcodeとコマンドラインツール(xcode-select --install)が必要です。
構成
GhostType/
├── App/
│ ├── GhostTypeApp.swift # Entry point, AppSettings, backend enum
│ ├── AppDelegate.swift # Menu bar, lifecycle, server teardown
│ ├── SettingsView.swift # Preferences and setup guide
│ └── MenuBarView.swift # Status menu
├── Core/
│ ├── AccessibilityManager.swift # AX text read/write, permissions
│ ├── GlobalKeyMonitor.swift # CGEventTap keystroke monitoring
│ ├── InputSourceMonitor.swift # IME state, pauses auto-trigger
│ ├── CompletionController.swift # Debounce, ghost text lifecycle
│ └── CompletionEngine.swift # Backend selection, circuit breaker
├── LLM/
│ ├── LLMProvider.swift # HTTP client, /infill and chat paths
│ ├── BundledLlamaServer.swift # Supervises the bundled llama-server
│ ├── ModelCatalog.swift # Downloadable models, on-disk layout
│ ├── ModelDownloader.swift # Resumable downloads with progress
│ └── CompletionGrammar.swift # GBNF construction
└── UI/
├── OverlayWindow.swift # Ghost text overlay window
└── CompletionPopup.swift # Multi-suggestion popup
クレジット
推論はllama.cpp(MIT)で動いています。文章用モデルはmradermacherがQwen3.5 BaseをGGUFに変換したもの、コード用モデルはggml-orgがQwen2.5-Coderを変換したものです。どちらのモデルもApache-2.0です。
ライセンス
MIT。使うのも、フォークするのも、商用で売るのも自由です。
GhostType Type less. Think more.