prompt.submit
A Claude Code settings key, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.
Hooks can now rewrite or drop your prompt before it is sent.
Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.242.
In the changelogs
23Releases whose published page names prompt.submit.
-
v2.1.300
Plugin mods gain a prompt-change event and richer permission decisions
Plugin mods get a
prompt.changeevent, and permission decisions can now name a setting and a deciderfound in this entry's text
-
v2.1.300
Fewer mods count as prompt hooks when Claude Code checks for them
The check for mods that hook prompt submission now applies an extra test, so some mods that counted before no longer do
found in this entry's text, named in this entry
-
v2.1.299
Plugin hooks can read images and documents attached to a prompt
Plugin hooks can now read, in chunks, the bytes of an image or document attached to the prompt being sent
found in this entry's text, named in this entry
-
v2.1.299
Prompts stopped by hooks now come with a reason
When a
UserPromptSubmithook orprompt.submithandler stops a prompt, Claude Code now records which kind of stop it wasfound in this entry's text, named in this entry
-
v2.1.299
Plugin hook denials now carry a reason
Default deny responses for plugin hooks such as tool.check and agent.spawn now include a reason alongside the decision
found in this entry's text
-
v2.1.299
Plugin hooks get stricter checks and a way to restore prompt text
Plugin hook handling now adds restoreArgument for prompt.submit and skill.prompt and rejects unsafe frontmatter data
found in this entry's text
-
v2.1.296
Interrupting a turn no longer lets a prompt slip past a checking hook
If you interrupt while a prompt-submit hook is still checking your prompt, a block it already gave stands
found in this entry's text
-
v2.1.296
Handling for turns interrupted while prompt hooks are running
Claude Code can now handle a turn that is interrupted while prompt-submit hooks are still checking your prompt
found in this entry's text, named in this entry
-
v2.1.286
Plugin hooks gain a prompt.compose method and an asUser option on submit
Plugin hooks can now call a new prompt.compose method, and prompt.submit now accepts an asUser option that must be true or false
found in this entry's text
-
v2.1.286
Plugins can submit a prompt marked as coming from the user
Plugins that submit prompts can now pass an
asUserflag, which marks the queued prompt as sent on the user's behalffound in this entry's text
-
v2.1.286
A new prompt.compose event joins the other prompt events
Claude Code now registers a
prompt.composeevent alongsideprompt.submit,prompt.fillandprompt.suggestfound in this entry's text
-
v2.1.280
New built-in plugin: responsive mode
A new built-in 'responsive mode' plugin makes Claude send a quick acknowledgment before thinking or using tools
found in this entry's text
-
v2.1.275
prompt.submit context building now goes through async storage-aware helper
Building the context attached to a submitted prompt is now an async, storage-aware step
found in this entry's text
-
v2.1.269
New plugin hook surface: prompt.submit with 'enter' phase
Plugins now get a prompt.submit 'enter' stage, and dropped context attached after calling next() now triggers a warning
found in this entry's text, named in this entry
-
v2.1.269
Prompt-submission hooks can now rewrite the submitted text, with richer drop diagnostics
Hooks can now rewrite your submitted prompt text, and dropped prompts get clearer error messages
found in this entry's text
-
v2.1.269
prompt.submit error now points to command.run
The prompt.submit plugin API error now tells you to use command.run instead
found in this entry's text
-
v2.1.269
prompt.submit hooks: late-arriving context after next() now warned and dropped, not silently lost
prompt.submit hooks that add context too late now get a warning instead of silently losing it
found in this entry's text, named in this entry
-
v2.1.265
Plugin telemetry site map gains command.run and command.describe hooks
Plugin hook telemetry adds command.run and command.describe event types
found in this entry's text
-
v2.1.260
New plugin-authoring skill for function-hooks plugins
A new bundled skill teaches how to write function-hook plugins.
found in this entry's text
-
v2.1.247
A prompt-submit hook can rename the session
A prompt-submit hook can now rename the current session and inject extra messages into the turn.
found in this entry's text
-
v2.1.242
Prompts pass through a submit hook chain that can rewrite or drop them
Hooks can now rewrite or drop your prompt before it is sent.
named in this entry, found in this entry's text
-
v2.1.242
Each hook event enforces what a plugin is allowed to change
Plugin hooks are limited in what they may rewrite, and cannot take over question prompts.
found in this entry's text
-
v2.1.242
Plugin modules with a
$API that can hook events and redraw the terminal UIPlugins can install code that intercepts tool calls and repaints parts of the terminal interface.
found in this entry's text
First cited
12The earliest release whose published evidence quoted prompt.submit was v2.1.242, 24 Aug 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.
6 further spans in the ledger name it. The list above is the earliest first and stops at 6.
Presence across releases
0The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.
Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the settings key does. All settings keys.