feat(prompt): resolve prompts referenced by name

Author: NickvanDyke

README.md

@@ -114,7 +114,7 @@ vim.g.opencode_opts = {
 
 ### 🗣️ Prompt — `require("opencode").prompt()` | `:[range]OpencodePrompt`
 
-Send a prompt.
+Send a prompt to `opencode`.
 
 Replaces placeholders with the corresponding context:
 
@@ -131,9 +131,25 @@ Replaces placeholders with the corresponding context:
 | `@diff` | Git diff |
 | `@grapple` | [grapple.nvim](https://github.com/cbochs/grapple.nvim) tags |
 
+Or pass a prompt name from `opts.prompts` to review, explain, and improve your code:
+
+| Name                               | Prompt                                                    |
+|------------------------------------|-----------------------------------------------------------|
+| `ask`         | *...*                                                             |
+| `explain`     | Explain `@this` and its context                                   |
+| `optimize`    | Optimize `@this` for performance and readability                  |
+| `document`    | Add comments documenting `@this`                                  |
+| `test`        | Add tests for `@this`                                             |
+| `review`      | Review `@this` for correctness and readability                    |
+| `diagnostics` | Explain `@diagnostics`                                            |
+| `fix`         | Fix `@diagnostics`                                                |
+| `diff`        | Review the following git diff for correctness and readability: `@diff`         |
+| `buffer`  | `@buffer`                                                             |
+| `this`    | `@this`                                                               |
+
 ### ✍️ Ask — `require("opencode").ask()`
 
-Input a prompt.
+Input a prompt to send to `opencode`.
 
 - Highlights placeholders.
 - Completes placeholders.
@@ -143,7 +159,7 @@ Input a prompt.
 
 ### 🧑‍🏫 Command — `require("opencode").command()`
 
-Send a [command](https://opencode.ai/docs/keybinds) to control `opencode`:
+Send a [command](https://opencode.ai/docs/keybinds) to `opencode`:
 
 | Command                   | Description                                              |
 |---------------------------|----------------------------------------------------------|
@@ -173,48 +189,9 @@ Toggle `opencode` via `opts.provider.toggle`. Usually not explicitly needed —
 
 A single entrypoint to all `opencode.nvim` functionality 😄
 
-#### Prompt
-
-Select from `opts.prompts` to review, explain, and improve your code:
-
-| Name                               | Prompt                                                    |
-|------------------------------------|-----------------------------------------------------------|
-| `ask`         | *...*                                                             |
-| `explain`     | Explain `@this` and its context                                   |
-| `optimize`    | Optimize `@this` for performance and readability                  |
-| `document`    | Add comments documenting `@this`                                  |
-| `test`        | Add tests for `@this`                                             |
-| `review`      | Review `@this` for correctness and readability                    |
-| `diagnostics` | Explain `@diagnostics`                                            |
-| `fix`         | Fix `@diagnostics`                                                |
-| `diff`        | Review the following git diff for correctness and readability: `@diff`         |
-| `buffer`  | `@buffer`                                                             |
-| `this`    | `@this`                                                               |
-
-#### Command
-
-Select from `opts.commands` to control `opencode`:
-
-| Command                   | Description                                              |
-|---------------------------|----------------------------------------------------------|
-| `session_new`             | Start a new session                                      |
-| `session_share`           | Share the current session                                |
-| `session_interrupt`       | Interrupt the current session                            |
-| `session_compact`         | Compact the current session (reduce context size)        |
-| `messages_copy`           | Copy the last message in the session                     |
-| `messages_undo`           | Undo the last message in the session                     |
-| `messages_redo`           | Redo the last message in the session                     |
-| `agent_cycle`             | Cycle the selected agent                                 |
-
-#### Provider
-
-Manage `opts.provider`:
-
-| Name | Function |
-|------|----------|
-| `toggle` | Toggle `opencode` |
-| `start` | Start `opencode` |
-| `show` | Show `opencode` |
+- Prompt library (`opts.prompts`)
+- Command library (`opts.commands`)
+- Manage provider (`opts.provider`)
 
 ## 👀 Events
 

lua/opencode.lua

@@ -18,18 +18,20 @@ end
 
 ---Prompt `opencode`.
 ---
----1. Clears the TUI input if `opts.clear`.
----2. Appends `prompt` to the TUI input.
----  - Injects `opts.contexts` into `prompt`.
----3. Submits the TUI input if `opts.submit`.
----  - Listens for Server-Sent-Events to forward as `OpencodeEvent` autocmd.
----  - Calls `opts.on_send`.
----4. Calls `callback` if provided.
+---1. Resolves `prompt` if it's a prompt name from `opts.prompts`.
+---2. Clears the TUI input if `opts.clear`.
+---3. Injects `opts.contexts` into `prompt`.
+---4. Appends `prompt` to the TUI input.
+---5. Submits the TUI input if `opts.submit`.
+---6. Listens for Server-Sent-Events to forward as `OpencodeEvent` autocmd.
+---7. Calls `callback` if provided.
 ---
----@param prompt string The prompt to send to `opencode`, with optional `opts.contexts` placeholders.
+---@param prompt string The prompt to send to `opencode`, or a prompt name from `opts.prompts`.
 ---@param opts? opencode.prompt.Opts
 ---@param callback? fun()
 function M.prompt(prompt, opts, callback)
+  local referenced_prompt = require("opencode.config").opts.prompts[prompt]
+  prompt = referenced_prompt and referenced_prompt.prompt or prompt
   opts = {
     clear = opts and opts.clear or false,
     submit = opts and opts.submit or false,