English | 日本語

Prompt Line is a macOS app developed to improve the prompt input experience in the terminal for CLI-based AI coding agents such as Claude Code, Codex CLI, and Gemini CLI. It provides a comfortable input experience through a floating window.

Key capabilities:

1. Quick input, quick paste — Floating window with Cmd+Shift+Space, paste anywhere with Cmd+Enter
2. Context search — Search agent skills, files, symbols, and more with / and @, with prompt history reuse
3. Extensible via plugins — Add custom search and skills with simple YAML files (Plugin Guide)

Quick launch with shortcut (Cmd+Shift+Space).
Type text and quick paste (Cmd+Enter).

The operation is the same as a typical text editor.
Of course, you can also use it in combination with a voice input app.
Pressing Enter will not automatically send the text, so you don't have to worry about line breaks.
It is also ideal for editing text entered by voice.
(This video uses superwhisper.)

Prompt history is saved and can be reused from the right menu.
Search is also available. (Cmd+f)

Can be launched anywhere there's a text input field.
Also convenient when you want to reuse the same prompt in other apps.

Of course, it also works with apps other than Terminal.

Type / or @ to search and autocomplete contexts such as agent skills, built-in commands, files, and symbols.
These can be extended with plugins. See: Plugin Guide | prompt-line-plugins

Agent Skills and Built-in Commands	File and Directory Search
Symbol Search	Custom Search (@agent:, @plan:, @team:, etc.)

• macOS 10.14 or later
• Node.js 20 or later
• pnpm
• Xcode Command Line Tools or Xcode (for compiling native tools)
• fd and rg (ripgrep) (for file search and symbol search features)

git clone https://github.com/nkmr-jp/prompt-line.git
cd prompt-line
git checkout v0.x.x  # Optional: replace with desired version tag
pnpm install
pnpm run install-app    # Build and install to /Applications (includes code signing setup)

Launch Prompt Line. An icon will appear in the system tray.

You can start using it with Cmd+Shift+Space.

Prompt Line requires accessibility permissions to paste text into other applications. A dialog box will appear on first use, so follow the instructions to set it up.

1. Open System Settings → Privacy and Security → Accessibility.
2. Find “Prompt Line” in the list and enable it.
3. If it is not in the list, add Prompt Line from Applications using the “+” button.

1. Open System Settings → Privacy and Security → Accessibility
2. Delete “Prompt Line” from Applications using the “-” button to reset permissions
3. The issue should be resolved after reconfiguring settings.

Accessibility permissions can also be reset using the following command:

pnpm run reset-accessibility

If you already have an older version installed and want to update to the latest version:

git pull
pnpm install
pnpm run install-app
pnpm run migrate-settings        # Migrate settings to latest defaults (auto-backup)

1. Move to where you want to input
2. Press Cmd+Shift+Space to open Prompt Line
3. Type your text
4. Press Cmd+Enter to paste text
5. Continue working

• History Panel - Click previous entries to reuse. Search is also available. (Cmd+f)
• Draft Autosave - Automatically saves your work
• Image Support - Paste clipboard images with Cmd+V
• File Opener - Open files from file path text (Ctrl+Enter or Cmd+Click)
• File Search - Search files by typing @
• Symbol Search - Search code symbols by typing @<lang>:<query> (e.g., @ts:Config)
• Custom Search - Search agents, plans, teams, history, etc. by typing @prefix: (extensible with plugins)

Settings file: ~/.prompt-line/settings.yaml (hot-reloaded, no restart needed)

See: Settings Reference | settings.example.yaml | Migration Guide

Plugins are YAML files that add agent skills (/), custom search (@prefix:), and built-in commands/skills/agents for CLI tools.

Quickest way: Place a YAML file in ~/.prompt-line/agent-skills/, ~/.prompt-line/custom-search/, or ~/.prompt-line/agent-built-in/ — no GitHub repo needed.

Share via GitHub: Install plugins from repositories:

# Global CLI setup (run once in the prompt-line project directory)
pnpm link

# Install plugins
prompt-line-plugin install github.com/nkmr-jp/prompt-line-plugins
prompt-line-plugin install github.com/user/repo@branch   # specific version

Details: docs/en/plugins.md
Example repo: prompt-line-plugins

• All data stored locally on your Mac
• No internet connection required
• Prompt history saved in ~/.prompt-line/history.jsonl
• Saved in JSON Lines format, so you can analyze it using DuckDB

See Contribution Guide for details.

MIT License - see LICENSE for details.