Merge pull request #238 from nkmr-jp/develop

Release: mentions fixes, directory detector improvements, and performance optimizations

Author: nkmr-jp

CLAUDE.md

@@ -346,23 +346,37 @@ IPC response → Renderer Process
 
 Total: 52 IPC channels across 9 specialized handlers
 
-### Built-in Commands Hot Reload
-
-Built-in command YAMLファイルの変更は自動的に検知され、リアルタイムで反映されます:
-
-**仕組み:**
-- ファイル監視: `~/.prompt-line/built-in-commands/`
-- デバウンス: 300ms
-- アプリ再起動不要
+### Built-in Commands
+
+Built-in commands are slash command definitions for external CLI tools (Claude Code, Codex CLI, Gemini CLI, etc.) stored as YAML files.
+
+**Source files:** `assets/built-in-commands/*.yml`
+**Installed to:** `~/.prompt-line/built-in-commands/` (copied via `pnpm run update-built-in-commands`)
+
+**Updating built-in commands to latest versions:**
+1. Check the latest slash commands for each CLI tool:
+   - **Claude Code**: Check [official changelog](https://github.com/anthropics/claude-code/releases) and [docs](https://code.claude.com/docs/en/interactive-mode#built-in-commands)
+   - **Codex CLI**: Check [source code](https://github.com/openai/codex) and [docs](https://developers.openai.com/codex/cli/slash-commands/)
+   - **Gemini CLI**: Check [docs](https://google-gemini.github.io/gemini-cli/docs/cli/commands.html) and [releases](https://github.com/google-gemini/gemini-cli/releases)
+2. Edit the YAML files in `assets/built-in-commands/` (add new commands, update changed descriptions; do not remove existing commands)
+3. Run `pnpm run update-built-in-commands` to install to user directory
+
+**YAML format:**
+```yaml
+name: claude
+color: amber
+reference: https://example.com/docs
+commands:
+  - name: command-name
+    description: Short description of what the command does
+    argument-hint: "[optional-args]"  # optional
+```
 
-**実装パターン:**
-- SettingsManagerと同じchokidar + EventEmitterパターン
-- YAMLファイル(.yaml, .yml)のみを監視
-- ファイル変更時にキャッシュクリアと'commands-changed'イベント発火
+**Hot reload:** Changes to `~/.prompt-line/built-in-commands/` are auto-detected (chokidar, 300ms debounce) and applied without app restart.
 
-**関連ファイル:**
-- `src/managers/built-in-commands-manager.ts` - ファイルウォッチング実装
-- `src/handlers/custom-search-handler.ts` - イベントリスナー
+**Related files:**
+- `src/managers/built-in-commands-manager.ts` - File watching and cache management
+- `src/handlers/custom-search-handler.ts` - Event listener for `commands-changed` events
 
 ## Platform-Specific Implementation
 

assets/built-in-commands/claude.yml

@@ -22,12 +22,12 @@ commands:
   - name: chrome
     description: Configure Claude in Chrome (Beta) settings
   - name: clear
-    description: Clear conversation history
+    description: "Clear conversation history and free up context (aliases: /reset, /new)"
   - name: compact
     description: Compact conversation with optional focus instructions
     argument-hint: "[instructions]"
   - name: config
-    description: Open the Settings interface (Config tab)
+    description: "Open the Settings interface (Config tab). Alias: /settings"
   - name: context
     description: Visualize current context usage as a colored grid
   - name: copy
@@ -38,14 +38,21 @@ commands:
     description: Troubleshoot the current session by reading the session debug log
     argument-hint: "[description]"
   - name: desktop
-    description: Hand off the current CLI session to the Claude Code Desktop app (macOS and Windows only)
+    description: "Continue the current session in the Claude Code Desktop app (macOS and Windows only). Alias: /app"
+  - name: diff
+    description: Interactive diff viewer for uncommitted changes and per-turn diffs
   - name: doctor
     description: Checks the health of your Claude Code installation
   - name: exit
-    description: Exit the REPL
+    description: "Exit the CLI. Alias: /quit"
   - name: export
     description: Export the current conversation to a file or clipboard
     argument-hint: "[filename]"
+  - name: extra-usage
+    description: Set additional usage to continue working when hitting rate limits
+  - name: fast
+    description: Toggle Fast mode on or off
+    argument-hint: "[on|off]"
   - name: feedback
     description: Submit feedback about Claude Code
   - name: fork
@@ -57,6 +64,8 @@ commands:
     description: Manage hook configurations for tool events
   - name: ide
     description: Manage IDE integrations and show status
+  - name: insights
+    description: Generate an analysis report of Claude Code sessions (project areas, operation patterns, friction points)
   - name: init
     description: Initialize project with CLAUDE.md guide
   - name: install-github-app
@@ -72,22 +81,26 @@ commands:
   - name: mcp
     description: Manage MCP server connections and OAuth authentication
   - name: memory
-    description: Edit CLAUDE.md memory files
+    description: Edit CLAUDE.md memory files, enable or disable auto-memory, and view auto-memory entries
   - name: mobile
     description: Show QR code to download the Claude mobile app
   - name: model
-    description: Select or change the AI model (use left/right arrows to adjust effort level)
+    description: Select or change the AI model (use left/right arrows to adjust effort level). Takes effect immediately
   - name: output-style
     description: Set the output style directly or from a selection menu
     argument-hint: "[style]"
+  - name: passes
+    description: Share a free 1-week Claude Code pass with friends (only shown for eligible accounts)
   - name: permissions
-    description: View or update permissions
+    description: "View or update permissions. Alias: /allowed-tools"
   - name: plan
     description: Enter plan mode directly from the prompt
   - name: plugin
     description: Manage Claude Code plugins
+  - name: reload-plugins
+    description: Reload all active plugins to apply pending changes without restarting
   - name: pr-comments
-    description: View pull request comments
+    description: Fetch and display comments from a GitHub pull request (auto-detects PR for current branch, requires gh CLI)
   - name: privacy-settings
     description: View and update your privacy settings
   - name: remote-env
@@ -103,12 +116,12 @@ commands:
     description: Rename the current session (without a name, generates one from conversation history)
     argument-hint: "[name]"
   - name: resume
-    description: "Resume a conversation by ID or name, or open the session picker"
+    description: "Resume a conversation by ID or name, or open the session picker. Alias: /continue"
     argument-hint: "[session]"
   - name: review
-    description: Request code review
+    description: Review a pull request for code quality, correctness, security, and test coverage (requires gh CLI)
   - name: rewind
-    description: Rewind the conversation and/or code, or summarize from a selected message
+    description: "Rewind the conversation and/or code to a previous point, or summarize from a selected message. Alias: /checkpoint"
   - name: sandbox
     description: "Enable sandboxed bash tool with filesystem and network isolation for safer, more autonomous execution"
   - name: security-review
@@ -131,7 +144,7 @@ commands:
     description: Resume a remote session from claude.ai (subscribers only)
     argument-hint: "[session]"
   - name: terminal-setup
-    description: Install Shift+Enter key binding for newlines (iTerm2 and VSCode only)
+    description: Configure terminal keybindings for Shift+Enter and other shortcuts (VS Code, Alacritty, Warp)
   - name: theme
     description: Change the color theme
   - name: todos
@@ -141,4 +154,4 @@ commands:
   - name: upgrade
     description: Upgrade to Max for higher rate limits and more Opus
   - name: vim
-    description: Enter vim mode for alternating insert and command modes
+    description: Toggle between Vim and Normal editing modes

assets/built-in-commands/codex.yml

@@ -12,28 +12,38 @@ commands:
   - name: agent
     description: Switch the active agent thread
   - name: approvals
-    description: Set what Codex can do without asking first
+    description: Choose what Codex is allowed to do
   - name: apps
-    description: Browse apps (connectors) and insert them into your prompt
+    description: Manage apps
+  - name: clean
+    description: Stop all background terminals
+  - name: clear
+    description: Clear the terminal and start a new chat
+  - name: collab
+    description: Change collaboration mode (experimental)
   - name: compact
-    description: Summarize the visible conversation to free tokens
+    description: Summarize conversation to prevent hitting the context limit
+  - name: copy
+    description: Copy the latest Codex output to your clipboard
   - name: diff
     description: Show the Git diff, including files Git isn't tracking yet
   - name: elevate-sandbox
-    description: Upgrade to elevated sandbox mode for enhanced permissions
+    description: Set up elevated agent sandbox
   - name: debug-config
-    description: Print config layer and requirements diagnostics
+    description: Show config layers and requirement sources for debugging
   - name: exit
     description: Exit the CLI (alias for /quit)
   - name: experimental
     description: Toggle experimental features
+  - name: fast
+    description: Toggle Fast mode for fastest inference at 2X plan usage
   - name: feedback
     description: Send logs to the Codex maintainers
   - name: fork
-    description: Fork the current conversation into a new thread
+    description: Fork the current chat
     argument-hint: "[session]"
   - name: init
-    description: Generate an AGENTS.md scaffold in the current directory
+    description: Create an AGENTS.md file with instructions for Codex
   - name: logout
     description: Sign out of Codex
   - name: mcp
@@ -42,30 +52,39 @@ commands:
     description: Attach a file to the conversation
     argument-hint: "<path>"
   - name: model
-    description: Choose the active model (and reasoning effort, when available)
+    description: Choose what model and reasoning effort to use
   - name: new
-    description: Start a new conversation inside the same CLI session
+    description: Start a new chat during a conversation
   - name: permissions
-    description: Set what Codex can do without asking first
+    description: Choose what Codex is allowed to do
   - name: personality
     description: Choose a communication style for responses
   - name: plan
     description: Switch to plan mode and optionally send a prompt
   - name: ps
-    description: Show experimental background terminals and their recent output
+    description: List background terminals
   - name: quit
     description: Exit the CLI
+  - name: realtime
+    description: Toggle realtime voice mode (experimental)
+  - name: rename
+    description: Rename the current thread
+    argument-hint: "[name]"
   - name: resume
     description: Resume a saved conversation from your session list
   - name: review
-    description: Ask Codex to review your working tree
+    description: Review current changes and find issues
+  - name: settings
+    description: Configure realtime microphone/speaker
   - name: skills
-    description: Browse and insert skills (experimental)
+    description: Use skills to improve how Codex performs specific tasks
   - name: status
-    description: Display session configuration and token usage
+    description: Show current session configuration and token usage
   - name: sandbox-add-read-dir
     description: Grant sandbox read access to an extra directory (Windows only)
   - name: statusline
     description: Configure TUI status-line fields interactively
+  - name: theme
+    description: Choose a syntax highlighting theme
   - name: undo
     description: Revert Codex's most recent turn

assets/built-in-commands/gemini.yml

@@ -17,7 +17,9 @@ commands:
     description: File an issue about Gemini CLI
     argument-hint: "[headline]"
   - name: chat
-    description: Manage conversation history with sub-commands for saving, resuming, listing, deleting, and sharing chats
+    description: Manage conversation history with sub-commands for saving, resuming, listing, deleting, sharing, and debugging chats
+  - name: commands
+    description: Manage custom slash commands loaded from .toml files
   - name: clear
     description: Clear the terminal screen including session history and scrollback
   - name: compress
@@ -28,22 +30,38 @@ commands:
     description: Manage workspace directories for multi-directory support
   - name: dir
     description: Alias for /directory
+  - name: docs
+    description: Open the Gemini CLI documentation in your browser
   - name: editor
     description: Open a dialog for selecting supported editors
   - name: exit
     description: Exit Gemini CLI
   - name: extensions
-    description: List all active extensions in the current session
+    description: "Manage extensions: install, enable, disable, explore, config, update, and more"
   - name: help
     description: Display help information about Gemini CLI and available commands
+  - name: hooks
+    description: "Manage hooks for intercepting and customizing behavior at lifecycle events"
+    argument-hint: "[disable-all|disable|enable-all|enable|list]"
+  - name: ide
+    description: "Manage IDE integration"
+    argument-hint: "[disable|enable|install|status]"
   - name: init
     description: Generate a tailored GEMINI.md context file for your project
   - name: mcp
-    description: List MCP servers, their status, and available tools
+    description: "Manage MCP servers: list, auth, disable, enable, refresh"
   - name: memory
-    description: Manage AI instructional context loaded from GEMINI.md files
+    description: Manage hierarchical instructional context loaded from GEMINI.md files
   - name: model
-    description: Open model selection dialog
+    description: "Open model selection dialog or set model directly"
+    argument-hint: "[manage|set <model-name>]"
+  - name: permissions
+    description: Manage folder trust settings and other permissions
+    argument-hint: "[trust <directory-path>]"
+  - name: plan
+    description: Switch to Plan Mode (read-only) and view the current plan
+  - name: policies
+    description: "Manage policies: list all active policies grouped by mode"
   - name: privacy
     description: Display the Privacy Notice and data collection preferences
   - name: quit
@@ -54,14 +72,21 @@ commands:
     description: Resume a previous conversation session
     argument-hint: "[session]"
   - name: rewind
-    description: Browse and rewind conversation history and file changes
+    description: Browse and rewind conversation history and file changes (Esc x2 shortcut)
   - name: settings
     description: Open the settings editor to view and modify settings
+  - name: setup-github
+    description: Set up GitHub Actions to triage issues and review PRs with Gemini
+  - name: shells
+    description: "Toggle background shells view and manage long-running processes. Alias: /bashes"
   - name: skills
     description: Manage Agent Skills for specialized workflows
     argument-hint: "[list|enable|disable|refresh]"
   - name: stats
-    description: Display session statistics including token usage and duration
+    description: "Display session statistics: session info, model tokens/quota, or per-tool stats"
+    argument-hint: "[session|model|tools]"
+  - name: terminal-setup
+    description: Configure terminal keybindings for multiline input (VS Code, Cursor, Windsurf)
   - name: theme
     description: Open a dialog to change the visual theme
   - name: tools