{"id":29804688,"url":"https://github.com/nkmr-jp/prompt-line","last_synced_at":"2026-04-30T02:04:25.700Z","repository":{"id":301788036,"uuid":"1002079792","full_name":"nkmr-jp/prompt-line","owner":"nkmr-jp","description":"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.","archived":false,"fork":false,"pushed_at":"2026-04-20T13:31:34.000Z","size":14074,"stargazers_count":145,"open_issues_count":0,"forks_count":15,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-20T14:41:28.370Z","etag":null,"topics":["claude-code","codex-cli","gemini-cli"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nkmr-jp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-14T17:08:40.000Z","updated_at":"2026-04-20T13:31:27.000Z","dependencies_parsed_at":"2025-12-17T19:06:57.167Z","dependency_job_id":null,"html_url":"https://github.com/nkmr-jp/prompt-line","commit_stats":null,"previous_names":["nkmr-jp/prompt-line"],"tags_count":93,"template":false,"template_full_name":null,"purl":"pkg:github/nkmr-jp/prompt-line","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nkmr-jp%2Fprompt-line","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nkmr-jp%2Fprompt-line/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nkmr-jp%2Fprompt-line/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nkmr-jp%2Fprompt-line/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nkmr-jp","download_url":"https://codeload.github.com/nkmr-jp/prompt-line/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nkmr-jp%2Fprompt-line/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32052534,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T11:35:06.609Z","status":"ssl_error","status_checked_at":"2026-04-20T11:34:48.899Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","codex-cli","gemini-cli"],"created_at":"2025-07-28T13:01:21.789Z","updated_at":"2026-04-30T02:04:25.686Z","avatar_url":"https://github.com/nkmr-jp.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# 🧑‍💻 Prompt Line\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/nkmr-jp/prompt-line)\n\n\u003c!-- Keep these links. Translations will automatically update with the README. --\u003e\nEnglish |\n[日本語](README_ja.md)\n\n## Overview\n\nPrompt 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](https://github.com/anthropics/claude-code), [Codex CLI](https://github.com/openai/codex), and [Gemini CLI](https://github.com/google-gemini/gemini-cli).\nIt provides a comfortable input experience through a floating window.\n\nKey capabilities:\n\n1. **Quick input, quick paste** — Floating window with `Cmd+Shift+Space`, paste anywhere with `Cmd+Enter`\n2. **Context search** — Search agent skills, files, symbols, and more with `/` and `@`, with prompt history reuse\n3. **Extensible via plugins** — Add custom search and skills with simple YAML files ([Plugin Guide](docs/en/plugins.md))\n\n\n## Features\n\n### Quick Launch, Quick Paste\nQuick launch with shortcut (`Cmd+Shift+Space`).\u003cbr\u003e\nType text and quick paste (`Cmd+Enter`).\n![doc1.gif](assets/doc1.gif)\n\n### Perfect for Editing Voice-Inputted Text\nThe operation is the same as a typical text editor. \u003cbr\u003e\nOf course, you can also use it in combination with a voice input app. \u003cbr\u003e\nPressing Enter will not automatically send the text, so you don't have to worry about line breaks. \u003cbr\u003e\nIt is also ideal for editing text entered by voice. \u003cbr\u003e\n(This video uses [superwhisper](https://superwhisper.com/).)\n![doc2.gif](assets/doc2.gif)\n\n### Search and Reuse Prompt History\nPrompt history is saved and can be reused from the right menu. \u003cbr\u003e\nSearch is also available. (`Cmd+f`)\n![doc3.gif](assets/doc3.gif)\n\n### Launch Anywhere\nCan be launched anywhere there's a text input field. \u003cbr\u003e\nAlso convenient when you want to reuse the same prompt in other apps.\n![doc4.gif](assets/doc4.gif)\n\nOf course, it also works with apps other than Terminal.\n![doc5.gif](assets/doc5.gif)\n\n### Context Search and Autocomplete\n\nType `/` or `@` to search and autocomplete contexts such as agent skills, built-in commands, files, and symbols.\u003cbr\u003e\nThese can be extended with plugins. See: [Plugin Guide](docs/en/plugins.md) | [prompt-line-plugins](https://github.com/nkmr-jp/prompt-line-plugins)\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd\u003eAgent Skills and Built-in Commands \u003cimg src=\"assets/doc9.png\"\u003e \u003c/td\u003e\n\u003ctd\u003eFile and Directory Search \u003cimg src=\"assets/doc10.png\"\u003e \u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd\u003eSymbol Search\u003cimg src=\"assets/doc11.png\"\u003e \u003c/td\u003e\n\u003ctd\u003eCustom Search (@agent:, @plan:, @team:, etc.) \u003cimg src=\"assets/doc14.png\"\u003e \u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n## 📦 Installation\n\n### System Requirements\n\n- macOS 10.14 or later\n- Node.js 20 or later\n- [pnpm](https://pnpm.io/installation)\n- Xcode Command Line Tools or Xcode (for compiling native tools)\n- [fd](https://github.com/sharkdp/fd) and [rg (ripgrep)](https://github.com/BurntSushi/ripgrep) (for file search and symbol search features)\n\n### Prompt Line Installation\n\n```bash\ngit clone https://github.com/nkmr-jp/prompt-line.git\ncd prompt-line\ngit checkout v0.x.x  # Optional: replace with desired version tag\npnpm install\npnpm run install-app    # Build and install to /Applications (includes code signing setup)\n```\n\nLaunch Prompt Line. An icon will appear in the system tray.\n\n\u003cdiv\u003e\u003cimg src=\"assets/doc6.png\" width=\"200\"\u003e\u003c/div\u003e\n\nYou can start using it with `Cmd+Shift+Space`.\n\n### Accessibility Permissions\n\nPrompt Line requires accessibility permissions to paste text into other applications.\nA dialog box will appear on first use, so follow the instructions to set it up.\n\n\u003cdiv\u003e\u003cimg src=\"assets/doc7.png\" width=\"200\"\u003e\u003c/div\u003e\n\n\n### Troubleshooting\n\n#### If the accessibility permissions dialog box does not appear\n\n1. Open **System Settings** → **Privacy and Security** → **Accessibility**.\n2. Find “Prompt Line” in the list and enable it.\n3. If it is not in the list, add Prompt Line from Applications using the “+” button.\n\n#### If “Prompt Line” is enabled in Accessibility Permissions but you still cannot paste\n\n1. Open **System Settings** → **Privacy and Security** → **Accessibility**\n2. Delete “Prompt Line” from Applications using the “-” button to reset permissions\n3. The issue should be resolved after reconfiguring settings.\n\nAccessibility permissions can also be reset using the following command:\n```bash\npnpm run reset-accessibility\n```\n\n## 📦 Update\n\nIf you already have an older version installed and want to update to the latest version:\n\n```bash\ngit pull\npnpm install\npnpm run install-app\npnpm run migrate-settings        # Migrate settings to latest defaults (auto-backup)\n```\n\n## Usage\n\n### Basic Workflow\n1. Move to where you want to input\n2. Press `Cmd+Shift+Space` to open Prompt Line\n3. Type your text\n4. Press `Cmd+Enter` to paste text\n5. Continue working\n\n### Features\n\n- **History Panel** - Click previous entries to reuse. Search is also available. (`Cmd+f`)\n- **Draft Autosave** - Automatically saves your work\n- **Image Support** - Paste clipboard images with `Cmd+V`\n- **File Opener** - Open files from file path text (`Ctrl+Enter` or `Cmd+Click`)\n- **File Search** - Search files by typing `@`\n- **Symbol Search** - Search code symbols by typing `@\u003clang\u003e:\u003cquery\u003e` (e.g., `@ts:Config`)\n- **Custom Search** - Search agents, plans, teams, history, etc. by typing `@prefix:` (extensible with [plugins](docs/en/plugins.md))\n\n## ⚙️ Settings\n\nSettings file: `~/.prompt-line/settings.yaml` (hot-reloaded, no restart needed)\n\nSee: [Settings Reference](docs/en/settings.md) | [settings.example.yaml](settings.example.yaml) | [Migration Guide](docs/en/migration.md)\n\n## 🔌 Plugins\n\nPlugins are YAML files that add agent skills (`/`), custom search (`@prefix:`), and built-in commands/skills/agents for CLI tools.\n\n**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.\n\n**Share via GitHub:** Install plugins from repositories:\n\n```bash\n# Global CLI setup (run once in the prompt-line project directory)\npnpm link\n\n# Install plugins\nprompt-line-plugin install github.com/nkmr-jp/prompt-line-plugins\nprompt-line-plugin install github.com/user/repo@branch   # specific version\n```\n\n**Details:** [docs/en/plugins.md](docs/en/plugins.md)\u003cbr\u003e\n**Example repo:** [prompt-line-plugins](https://github.com/nkmr-jp/prompt-line-plugins)\n\n## Prompt History\n\n- All data stored locally on your Mac\n- No internet connection required\n- Prompt history saved in `~/.prompt-line/history.jsonl`\n- Saved in JSON Lines format, so you can analyze it using [DuckDB](https://duckdb.org/)\n\n![doc8.png](assets/doc8.png)\n\n## Contributing\n\nSee [Contribution Guide](CONTRIBUTING.md) for details.\n\n## License\n\nMIT License - see [LICENSE](./LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnkmr-jp%2Fprompt-line","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnkmr-jp%2Fprompt-line","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnkmr-jp%2Fprompt-line/lists"}