🧑‍💻 Prompt Line

English | 日本語

概要

Prompt Lineは、Claude Code、Codex CLI、Gemini CLI などのCLI型AIコーディングエージェントのターミナルでのプロンプト入力体験の向上を目的として開発したmacOSアプリです。 フローティングウィンドウによる快適な入力体験を提供します。

主な機能：

1. サクッと入力、サクッと貼り付け — Cmd+Shift+Spaceでフローティングウィンドウを起動、Cmd+Enterでどこにでも貼り付け
2. コンテキスト検索 — /や@でエージェントスキル、ファイル、シンボルなどを検索。プロンプト履歴の再利用も可能
3. プラグインで拡張 — シンプルなYAMLファイルでカスタム検索やスキル検索を追加（プラグインガイド）

特徴

サクッと起動、サクッと貼付け

ショートカットでサクッと起動 (Cmd+Shift+Space)。
テキスト入力してサクッと貼付け(Cmd+Enter)。

音声入力したテキストの編集にも最適

操作性は一般的なテキストエディタと同じです。
もちろん音声入力アプリと組み合わせて使うこともできます。
Enterを押しても勝手に送信されないので、改行する場合も気をつける必要はありません。
音声入力したテキストの編集にも最適です。
(この動画ではsuperwhisperを使っています。)

プロンプト履歴を検索して再利用可能

プロンプト履歴は保存されており、右のメニューから再利用可能です。
検索もできます。(Cmd+f)

どこでも起動

テキスト入力フィールドであればどこでも起動できます。
同じプロンプトを他のアプリで再利用したい場合にも便利です。

もちろん、ターミナル以外でも使えます。

コンテキスト検索と入力補完

/や@を入力するとエージェントスキル・組み込みコマンド・ファイル・シンボルなどのコンテキストを検索して入力補完できます。
プラグインで拡張可能です。詳細: プラグインガイド | prompt-line-plugins

エージェントスキルと組み込みコマンド	ファイルとディレクトリ検索
シンボル検索	カスタム検索 (@agent:, @plan:, @team:, @ghq: 等)

📦 インストール

システム要件

• macOS 10.14以降
• Node.js 20以上
• pnpm
• Xcodeコマンドラインツール または Xcode（ネイティブツールのコンパイル用）
• fd と rg(ripgrep)（ファイル検索・シンボル検索機能で使用）

Prompt Line の インストール

git clone https://github.com/nkmr-jp/prompt-line.git
cd prompt-line
git checkout v0.x.x  # 任意: 必要なバージョンタグに置き換え
pnpm install
pnpm run install-app    # ビルドして/Applicationsにインストール（コード署名セットアップ含む）

Prompt Lineを起動。システムトレーにアイコンが表示されます。

Cmd+Shift+Spaceで使い始められます。

アクセシビリティ権限

Prompt Lineが他のアプリケーションにテキストを貼り付けるには、アクセシビリティ権限が必要です。
初回使用時にダイアログボックスが表示されるので、指示に従って設定してください。

トラブルシューティング

アクセシビリティ権限のダイアログボックスが表示されない場合

1. システム設定 → プライバシーとセキュリティ → アクセシビリティを開く
2. リストから「Prompt Line」を見つけて有効にする
3. リストにない場合は「+」ボタンでApplicationsからPrompt Lineを追加

アクセシビリティ権限で「Prompt Line」が有効になっているのに貼付けできない場合

1. システム設定 → プライバシーとセキュリティ → アクセシビリティを開く
2. 「-」ボタンでApplicationsからPrompt Lineを削除して権限をリセット
3. 再度設定すれば動くようになります。

アクセシビリティ権限のリセットは以下のコマンドでもできます。

pnpm run reset-accessibility

📦 アップデート

既に古いバージョンをインストール済みで、最新版にアップデートする場合:

git pull
pnpm install
pnpm run install-app
pnpm run migrate-settings        # 設定ファイルを最新のデフォルトに移行（自動バックアップ）

使用方法

基本的なワークフロー

1. 入力したい場所に移動
2. Cmd+Shift+Spaceを押してPrompt Lineを開く
3. テキストを入力
4. Cmd+Enterを押してテキストを貼り付け
5. 作業を継続

機能

• 履歴パネル - 過去のエントリをクリックして再利用。検索も可能。(Cmd+f)
• ドラフト自動保存 - 作業内容を自動的に保存
• 画像サポート - Cmd+Vでクリップボード画像を貼り付け
• ファイルオープン - ファイルパスのテキストからファイルを起動 (Ctrl+Enter or Cmd+クリック)
• ファイル検索 - @を入力してファイルを検索
• シンボル検索 - @<言語>:<クエリ>と入力してコードシンボルを検索 (例: @ts:Config)
• カスタム検索 - @prefix: でエージェント、プラン、チーム、履歴などを検索（プラグインで拡張可能）

⚙️ 設定

設定ファイル: ~/.prompt-line/settings.yaml（ホットリロード対応、再起動不要）

参照: 設定リファレンス | settings.example.yaml | マイグレーションガイド

🔌 プラグイン

プラグインはYAMLファイルで、エージェントスキル（/）、カスタム検索（@prefix:）、CLIツールの組み込みコマンド・スキル・エージェントを追加します。

最も簡単な方法: ~/.prompt-line/agent-skills/、~/.prompt-line/custom-search/、~/.prompt-line/agent-built-in/ にYAMLファイルを配置するだけ。GitHubリポジトリは不要です。

GitHubで共有: リポジトリからプラグインをインストール：

# グローバルCLIセットアップ（prompt-lineプロジェクトディレクトリで一度だけ実行）
pnpm link

# プラグインのインストール
prompt-line-plugin install github.com/nkmr-jp/prompt-line-plugins
prompt-line-plugin install github.com/user/repo@branch   # バージョン指定

詳細: docs/ja/plugins.md
リポジトリ例: prompt-line-plugins

プロンプト履歴

• すべてのデータはMac内にローカル保存
• インターネット接続不要
• プロンプト履歴は ~/.prompt-line/history.jsonl に保存
• JSON Lines形式で保存されているのでDuckDBを使って分析することもできます。

貢献

詳細は Contribution Guide をご確認ください。

ライセンス

MIT License - 詳細は LICENSE をご確認ください。