Skip to content
プロジェクト

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

オリジナル

GhostType

English · 日本語 · 简体中文 · 繁體中文 · 한국어 · Español · Français · Deutsch · Português

GhostType

Macのあらゆるテキスト欄で、Tabキーひとつで続きが書ける。しかも全部あなたのMacの中で動く。

macOS 14+ Swift 5.9+ MIT 100% Local

打鍵を止めるとカーソル位置にグレーの補完が現れ、Tabで確定する

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、その他どのテキスト欄でも同じように動きます。

GhostType in Gmail
Gmailで返信を書く

GhostType on X
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回だけの作業です。

  1. GhostTypeを開く。macOSが「開発元を確認できません」と拒否します
  2. システム設定 > プライバシーとセキュリティを開き、下方のセキュリティまで進む
  3. 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.