{"name":"prompt.fill","slug":"prompt-fill","family":"setting","title":"Settings keys","noun":"settings key","description":"Plugins can now fill in or suggest text directly in the prompt input box via two new prompt.fill and prompt.suggest actions","description_source":"entry","described_by":{"version":"2.1.268","anchor":"new-plugin-api-actions-promptfill-and-promptsuggest"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.319","builds":0,"mined_builds":159,"first_cited":{"version":"2.1.268","released_at":"2026-09-10 18:41:11","spans":4}},"aliases":[],"entries":[{"version":"2.1.309","anchor":"promptfill-accepts-a-cursor-position","heading":"Filling the prompt box can now set where the cursor lands","line":"prompt.fill now accepts an optional cursor position, so text placed in the prompt box can leave the cursor at a chosen point","released_at":"2026-10-22 20:34:13","reason":"named in this entry, found in this entry's text"},{"version":"2.1.304","anchor":"prompt-fill-gains-answerspress-and-a-new-envonboarding-defa","heading":"Plugins filling the prompt box can pass an extra value","line":"When a plugin fills in the prompt box, it can now pass an extra value along, and a new onboarding setting defaults to on","released_at":"2026-10-19 19:47:15","reason":"found in this entry's text, named in this entry"},{"version":"2.1.290","anchor":"remote-control-permission-responses-tracked-by-tool-name-p","heading":"Remote control keeps a permission prompt open when the answer is for another tool","line":"When a session is controlled remotely, a permission answer naming the wrong tool no longer dismisses the prompt that is waiting","released_at":"2026-10-05 18:12:44","reason":"found in this entry's text"},{"version":"2.1.286","anchor":"promptcompose-event-and-focus-mode-constant","heading":"A new prompt.compose event joins the other prompt events","line":"Claude Code now registers a `prompt.compose` event alongside `prompt.submit`, `prompt.fill` and `prompt.suggest`","released_at":"2026-09-30 17:14:38","reason":"found in this entry's text"},{"version":"2.1.282","anchor":"promptfill-now-reports-why-a-fill-was-refused-when-a-dialog","heading":"prompt.fill now says why it did not fill the prompt","line":"Plugin hooks calling `prompt.fill` now get a `refusal` reason such as \"dialog\" or \"no_composer\" when the prompt was not filled","released_at":"2026-09-24 15:56:22","reason":"found in this entry's text, named in this entry"},{"version":"2.1.277","anchor":"plugin-hook-dispatch-deep-copies-input-for-a-fixed-set-of-ui","heading":"Plugin hook dispatch deep-copies input for a fixed set of UI\/registration events","line":"Plugin hooks now receive a deep copy of the event payload for UI and registration events, not the original","released_at":"2026-09-18 16:22:26","reason":"found in this entry's text"},{"version":"2.1.275","anchor":"new-plugin-hook-api-promptread","heading":"New plugin hook API: $.prompt.read","line":"New plugin hook API lets plugins read the current text and cursor position in the prompt box","released_at":"2026-09-17 20:20:31","reason":"found in this entry's text"},{"version":"2.1.275","anchor":"plugin-originated-slash-actions-now-include-promptfill-and","heading":"Plugin-originated slash actions now include prompt.fill and prompt.suggest, not just command.run","line":"Plugin-triggered slash actions now also cover prompt.fill and prompt.suggest, not just command.run","released_at":"2026-09-17 20:20:31","reason":"found in this entry's text, named in this entry"},{"version":"2.1.268","anchor":"new-plugin-api-actions-promptfill-and-promptsuggest","heading":"New plugin API actions: prompt.fill and prompt.suggest","line":"Plugins can now fill in or suggest text directly in the prompt input box via two new prompt.fill and prompt.suggest actions","released_at":"2026-09-10 18:41:11","reason":"found in this entry's text, named in this entry"}],"entries_total":9,"docs":[{"source":"claude-code","path":"plugins\/mods\/reference","title":"Mods reference","documented":false},{"source":"claude-code","path":"plugins\/mods\/test","title":"Test a mod","documented":false}],"docs_total":2,"gates":[],"related":[{"name":"prompt","slug":"prompt","description":"Auto-mode is stricter: text you asked Claude to review can't grant permission on your behalf."},{"name":"prompt.attachment","slug":"prompt-attachment","description":"New `prompt.attachment` hook lets plugins rewrite or remove text attached to a message"},{"name":"prompt.autocomplete","slug":"prompt-autocomplete","description":"A new `prompt.autocomplete` plugin hook lets plugins add completion rows under the prompt, including for desktop, mobile and VS Code composers"},{"name":"prompt.change","slug":"prompt-change","description":"The `prompt.change` hook runs when a plugin or the landing screen changes the prompt box, and stops itself if plugins keep refilling it"},{"name":"prompt.compose","slug":"prompt-compose","description":"Claude Code can now compare two versions of a changing schema and label the difference, such as text only or new live additions"},{"name":"prompt.context","slug":"prompt-context","description":"A new prompt.context hook event lets plugins add named context blocks to a prompt, capped at 32 blocks and 32000 characters."},{"name":"prompt.edit","slug":"prompt-edit","description":"Plugins can now hook into 'prompt.attachment' to rewrite or drop attachment text before it reaches the model"},{"name":"prompt.md","slug":"prompt-md","description":"`plugin eval` warns when writing results inside a plugin's own directory could get picked up as plugin components"},{"name":"prompt.paint","slug":"prompt-paint","description":"A new plugin hook, `prompt.paint`, takes text and decorations and returns the text and cursor position to show in the prompt"},{"name":"prompt.read","slug":"prompt-read","description":"New plugin hook API lets plugins read the current text and cursor position in the prompt box"}],"url":"https:\/\/changelogs.core-directive.com\/reference\/setting\/prompt-fill","family_url":"https:\/\/changelogs.core-directive.com\/reference\/setting.json"}