vinzdg/codenotch

Codenotch – AI コーディングアシスタントの使用制限用の小さな画面上モニター

概要

• macOS（および Rust/Tauri ポートによる Windows）ユーティリティで、画面の任意の端に固定された小さな「ノッチ」として存在します。ノッチ内の各リングはコーディングアシスタントプロバイダー（Claude、Cursor、Codex、Ollama など）を表し、プロバイダーの使用クォータがどれだけ消費されたか、クォータがいつリセットされるか、アシスタントが現在ビジーか、完了か、待機中かを示します。

必要な理由

• 毎日/毎週のトークン制限がある複数の AI コーディングツールを定期的に使用する場合、Codenotch は一目で確認できるビューを提供し、予期せずクォータに達することを防ぎます。
• 制限が 80% を超えるか 100% に達したときにもアラートを発します。
• UI は控えめで、ホバーで拡張する細いピル型で、常時表示またはメニューバーモードを選択できます。

主な機能（README に記載）

• プロバイダーサポート – クラウド（Claude、DeepSeek、Antigravity、OpenCode、GitHub Copilot など）とローカルランタイム（Ollama、LM Studio、oMLX）の両方を含む数十のサービスから使用データを読み取ります。ほとんどのプロバイダーは、それぞれの CLI またはデスクトップアプリが既に保存している認証情報を再利用します。一部（DeepSeek、MiniMax、QianwenAI）は、埋め込み WebView を介した明示的なサインインが必要です。
• ライブステータス – セッションがビジーな間リングが回転し、ブロックされると琥珀色にパルスし、現在の制限ウィンドウ、リセット時間、セッション状態を示すツールチップを表示します。
• マルチアカウント処理 – 個別の設定ディレクトリ（例：~/.claude-work）を検出し、アカウントごとに個別のリングを作成します。
• 電話コンパニオン – iOS/Android アプリがローカルネットワークの QR コードペアリングを介して同じ使用率をミラーリングできます。
• カスタムエンドポイント – 任意の OpenAI 互換、Anthropic、または Gemini エンドポイントを追加し、使用データを手動で入力できます。
• 速度と思考メトリクス – ローカルモデル（Ollama、LM Studio、oMLX）の場合、毎秒トークン数と「思考」時間の測定を有効にできます。プロンプトを Codenotch に送信する必要はありません。
• 高度に設定可能な UI – エッジ配置、サイズ、色、常時表示 vs ホバーのみ、Dock/メニューバーの表示、メニューバーサマリーに表示するプロバイダーを選択できます。
• アラート – プロバイダーの使用率が 80% を超えるか 100% に達したときに macOS 通知が一度だけ発火し、プロバイダーごとのミュートコントロールがあります。
• アップデート – macOS 用の署名済み、公証済みリリース。Tauri ポート用の Windows インストーラー（未署名）。main ブランチのプレビュービルド。

インストール

• macOS – リリースページから最新の Codenotch.dmg をダウンロードします。アプリは署名され公証されています。アプリケーションにドラッグした後、隔離フラグをクリアする必要がある場合があります（xattr -dr com.apple.quarantine /Applications/Codenotch.app）。
• Windows – Codenotch-Setup.exe をダウンロードします。インストーラーは管理者権限なしで実行され、必要に応じて WebView2 を取得します。
• ソースから – README は、Swift macOS アプリまたは Rust/Tauri Windows バージョンをコンパイルするためのビルドセクション（ここでは再現されていません）を指しています。

内部の仕組み

• クラウドプロバイダーの場合、公式 CLI またはデスクトップアプリが使用する同じ使用エンドポイントをクエリし、マシンに既に存在する OAuth トークン、API キー、またはキーチェーンエントリを再利用します。
• ローカルランタイムの場合、実行中のサーバーを検出し、ステータスソケットまたはログファイル（~/.lmstudio/server-logs、~/.omlx/logs/server.log）を読み取り、トークン数と速度メトリクスを抽出します。プロンプトや応答データが Codenotch に送信されることはありません。
• 電話アプリは同じネットワーク上でローカルに通信します。ペアリングは 5 分後に期限切れになる使い捨て QR コードを使用します。

ライセンス

• MIT（README のバッジに示されています）。

誰が使うか

• 複数の AI コーディングアシスタントを管理し、クォータ制限内に留まる必要がある開発者。
• アシスタントがユーザー入力を待っているときに共有視覚キューを望むチーム。
• 各プロバイダーのダッシュボードを開く代わりに、軽量で常時表示のステータスバーを好む人。

---

上記のすべての情報はプロジェクトの README から直接取得されています。追加の機能は推測されていません。