Answer: Terminal tools end the current agent turn only when the tool succeeds; a failure, denial, rejection, timeout, or input-validation error remains visible to the model so it can recover or retry. Terminality should be used only for tools whose successful completion should end the turn, and ordinary tools should leave it unset. Status: Confirmed Entry: tool/github-copilot/agents-and-automation/terminal-tool-behavior Revision: 3 Digest: sha256:3e92464db9969ea7 (changes whenever the content changes) Timeline: Created: 2026-11-13T03:27:55Z Last changed: 2026-11-19T13:01:47Z (Usage guidance: — → Use terminality only for tools whose successful completion should end the turn. Ordinary tools should leave it unset.) Last verified: 2026-11-20T13:08:09Z Next check: 2026-11-21T13:08:09Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of Terminal tool behavior | isTerminal ends the current agent turn only when the tool succeeds | [1] | 2026-11-20 Error handling | A failure, denial, rejection, timeout, or input-validation error remains visible to the model so it can recover or retry | [1] | 2026-11-20 Node.js option | isTerminal | [1] | 2026-11-20 Python option | is_terminal | [1] | 2026-11-20 Go option | IsTerminal | [1] | 2026-11-20 Java option | Tool Definition.is Terminal(true) or @Copilot Tool(is Terminal = true) | [1] | 2026-11-20 Rust option | with_is_terminal(true) | [1] | 2026-11-20 Usage guidance | Use terminality only for tools whose successful completion should end the turn. Ordinary tools should leave it unset. | [1] | 2026-11-20 Sources: [1] GitHub. "Context clearing and terminal tools - GitHub Docs". https://docs.github.com/en/copilot/how-tos/copilot-sdk/features/context-management Role: primary. Accessed: 2026-11-20T13:08:09Z Quote: "Terminal-tool behavior isTerminal ends the current agent turn only when the tool succeeds." (Supports: Terminal tool behavior) Quote: "A failure, denial, rejection, timeout, or input-validation error remains visible to the model so it can recover or retry." (Supports: Error handling) Quote: "Node.js isTerminal" (Supports: Node.js option) Quote: "Python is_terminal" (Supports: Python option) Quote: "Go IsTerminal" (Supports: Go option) Quote: "Java Tool Definition.is Terminal(true) or @Copilot Tool(is Terminal = true)" (Supports: Java option) Quote: "Rust with_is_terminal(true)" (Supports: Rust option) Quote: "Use terminality only for tools whose successful completion should end the turn. Ordinary tools should leave it unset." (Supports: Usage guidance) Snapshot SHA-256: 9f4cd4eb70554c92a7841d40e2f120cbfcad563ed92aa423b31cea76ec17dc05 (captured 2026-11-18T13:03:13Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-18T13:03:14Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T13:08:09Z. No independent second source is configured for this entry Last successful check: 2026-11-20T13:08:09Z Last attempt: 2026-11-20T13:08:09Z Notes and limitations: Extracted automatically from a single official source (section "Terminal-tool behavior"). Related: https://latestn.com/tool/github-copilot/agents-and-automation/test-custom-agent How do I test a custom agent in my GitHub Copilot organization before releasing it? https://latestn.com/tool/github-copilot/agents-and-automation/test-custom-agent-2 How do I test a custom agent in GitHub Copilot? https://latestn.com/tool/github-copilot/agents-and-automation/toggle-cloud-agent-repos How do I disable or enable the GitHub Copilot cloud agent in my repositories? https://latestn.com/tool/github-copilot/agents-and-automation/supported-coding-agents Which coding agents are supported by GitHub Agentic Workflows? https://latestn.com/tool/github-copilot/agents-and-automation/supported-third-party-agents Which third-party coding agents does GitHub Copilot support? https://latestn.com/tool/github-copilot/agents-and-automation/switch-to-windows-environment How do I switch GitHub Copilot cloud agent to a Windows development environment? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-19T13:01:47Z | changed | Usage guidance: — → Use terminality only for tools whose successful completion should end the turn. Ordinary tools should leave it unset. | [1] 2026-11-19T13:01:47Z | changed | Java option: — → Tool Definition.is Terminal(true) or @Copilot Tool(is Terminal = true) | [1] 2026-11-19T13:01:47Z | changed | Error handling: — → A failure, denial, rejection, timeout, or input-validation error remains visible to the model so it can recover or retry | [1] 2026-11-19T13:01:47Z | changed | Terminal tool behavior: — → isTerminal ends the current agent turn only when the tool succeeds | [1] 2026-11-19T13:01:47Z | changed | usage guidance: Use terminality only for tools whose successful completion should end the turn. Ordinary tools should leave it unset. → — | [1] 2026-11-19T13:01:47Z | changed | error handling: A failure, denial, rejection, timeout, or input-validation error remains visible to the model so it can recover or retry → — | [1] 2026-11-19T13:01:47Z | changed | terminal tool behavior: isTerminal ends the current agent turn only when the tool succeeds → — | [1] 2026-11-17T13:26:02Z | changed | usage guidance: — → Use terminality only for tools whose successful completion should end the turn. Ordinary tools should leave it unset. | [1] 2026-11-17T13:26:02Z | changed | error handling: — → A failure, denial, rejection, timeout, or input-validation error remains visible to the model so it can recover or retry | [1] 2026-11-17T13:26:02Z | changed | terminal tool behavior: — → isTerminal ends the current agent turn only when the tool succeeds | [1] 2026-11-17T13:26:02Z | changed | Usage guidance: Use terminality only for tools whose successful completion should end the turn. Ordinary tools should leave it unset. → — | [1] 2026-11-17T13:26:02Z | changed | Error handling: A failure, denial, rejection, timeout, or input-validation error remains visible to the model so it can recover or retry → — | [1] 2026-11-17T13:26:02Z | changed | Terminal tool behavior: isTerminal ends the current agent turn only when the tool succeeds → — | [1] 2026-11-13T03:27:55Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/github-copilot/agents-and-automation/terminal-tool-behavior/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/github-copilot/agents-and-automation/terminal-tool-behavior POST: https://latestn.com/dispute/tool/github-copilot/agents-and-automation/terminal-tool-behavior with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/github-copilot/agents-and-automation/terminal-tool-behavior?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do terminal tools behave in the GitHub Copilot SDK? Revision 3, last verified 2026-11-20T13:08:09Z. https://latestn.com/tool/github-copilot/agents-and-automation/terminal-tool-behavior (accessed 2026-11-21T09:57:01Z). @misc{LatestN_tool_github_copilot_agents_and_automation_terminal_tool_behavior_r3, title = {How do terminal tools behave in the GitHub Copilot SDK?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/github-copilot/agents-and-automation/terminal-tool-behavior}}, note = {Revision 3; digest sha256:3e92464db9969ea7; last verified 2026-11-20T13:08:09Z; accessed 2026-11-21T09:57:01Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/github-copilot/agents-and-automation/terminal-tool-behavior