ANSI Escape Code Terminal Injection

Detects malicious ANSI escape sequences embedded in tool output or skill content that can hijack terminal display (clear screen, relocate cursor, overwrite prompts, execute OSC-series operating-system commands). Used to hide content from human review, inject fake prompts into CLI sessions, or trigger terminal exploits. Observed in garak ansiescape probe. Also relevant to terminal-based agent frameworks where tool output is rendered directly to a user's shell.

Response Actions

References

1. 01

   OSC (Operating System Command) sequence - can set title, execute hyperlinks, or trigger terminal-specific commands

   field: tool_responseop: regex
2. 02

   Cursor-position / screen-clear CSI codes - H/f move cursor, J/K clear display

   field: tool_responseop: regex
3. 03

   Alternate screen buffer or mouse-mode escapes - typical of terminal hijack

   field: tool_responseop: regex
4. 04

   Escaped ANSI sequences in literal string form (evades raw-byte filters)

   field: contentop: regex
5. 05

   OSC 7 (report working directory) or OSC 8 (hyperlink) pointing to external URI - potential SSRF / phishing vector

   field: tool_responseop: regex

Attack Examples (Rule Triggers)

1. ]0;evil titleNormal looking output

2. Output followsGreat choice!

3. Click here: ]8;;https://evil.example.comsafe-looking text]8;;

4. Escaped version in JSON payload: \x1b[31mred text\x1b[0m\x1b[2J clears screen

5. [?1049h Switched to alternate screen buffer

Real-world attack payloads (sanitized). Used for regression testing.

Benign Examples (Rule Doesn't Trigger)

1. Normal tool output without any escape sequences

2. A Python script that prints hello world

3. Documentation explains that \x1b stands for ESC in ASCII table

4. The CVE database lists terminal-related vulnerabilities

5. git log --color=always output:\nauthor Alice

Known False Positive Contexts

• ▸Legitimate terminal color codes from developer tools (ls --color, grep --color) without OSC/cursor hijack
• ▸Log files that preserve ANSI color from CI/CD systems
• ▸Documentation discussing terminal escape sequences in code examples

Documented Evasion Techniques

1. Technique: unicode-escape-encoded

   \u001b]0;hidden\u0007

   Unicode-escape form still matches condition 4
2. Technique: html-entity-encoded

   OSC encoded as HTML: ]0;title

   HTML entity form evades current regex - would need an additional condition
3. Technique: base64-double-encoded

   Base64 wrapped: G10wO2hpZGRlbgc= (decode and execute)

   Caught by ATR-2026-00256 base-N encoding rule if decode instruction present

Publicly documented bypasses. We disclose known limitations rather than pretend they don't exist.

title: 'ANSI Escape Code Terminal Injection'
id: ATR-2026-00259
rule_version: 1
status: experimental
description: >
  Detects malicious ANSI escape sequences embedded in tool output or skill content
  that can hijack terminal display (clear screen, relocate cursor, overwrite prompts,
  execute OSC-series operating-system commands). Used to hide content from human
  review, inject fake prompts into CLI sessions, or trigger terminal exploits.
  Observed in garak ansiescape probe. Also relevant to terminal-based agent
  frameworks where tool output is rendered directly to a user's shell.
author: "ATR Community (via NVIDIA garak ansiescape probe)"
date: "2026/04/19"
schema_version: "0.1"
detection_tier: pattern
maturity: experimental
severity: high
references:
  owasp_llm:
    - "LLM02:2025 - Insecure Output Handling"
  owasp_agentic:
    - "ASI08:2026 - Output Handling"
  mitre_atlas:
    - "AML.T0057 - LLM Data Leakage"
  research:
    - "https://github.com/NVIDIA/garak/blob/main/garak/probes/ansiescape.py"
    - "https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2003-0063"
tags:
  category: tool-poisoning
  subcategory: ansi-escape
  scan_target: both
  confidence: high
agent_source:
  type: mcp_exchange
  framework: [any]
  provider: [any]
detection:
  conditions:
    - field: tool_response
      operator: regex
      value: '\x1b\][0-9]+;[^\x07\x1b]*(?:\x07|\x1b\\)'
      description: 'OSC (Operating System Command) sequence - can set title, execute hyperlinks, or trigger terminal-specific commands'
    - field: tool_response
      operator: regex
      value: '\x1b\[[0-9;]*[HfJK]'
      description: 'Cursor-position / screen-clear CSI codes - H/f move cursor, J/K clear display'
    - field: tool_response
      operator: regex
      value: '\x1b\[(?:\?1049h|\?47h|\?1000[hl]|\?2004[hl])'
      description: 'Alternate screen buffer or mouse-mode escapes - typical of terminal hijack'
    - field: content
      operator: regex
      value: '\\x1b\[[0-9;]*[A-Za-z]|\\u001b\[[0-9;]*[A-Za-z]|\\033\[[0-9;]*[A-Za-z]'
      description: 'Escaped ANSI sequences in literal string form (evades raw-byte filters)'
    - field: tool_response
      operator: regex
      value: '\x1b\][78];(?:file|https?)://[^\x07]{1,200}\x07'
      description: 'OSC 7 (report working directory) or OSC 8 (hyperlink) pointing to external URI - potential SSRF / phishing vector'
  condition: any
  false_positives:
    - 'Legitimate terminal color codes from developer tools (ls --color, grep --color) without OSC/cursor hijack'
    - 'Log files that preserve ANSI color from CI/CD systems'
    - 'Documentation discussing terminal escape sequences in code examples'
response:
  actions: [alert, block_tool]
  message_template: >
    [ATR-2026-00259] ANSI escape injection detected in tool output - potential terminal hijack or display manipulation.
test_cases:
  true_positives:
    - input: "\x1b]0;evil title\x07Normal looking output"
      expected: triggered
    - input: "Output follows\x1b[2J\x1b[HGreat choice!"
      expected: triggered
    - input: "Click here: \x1b]8;;https://evil.example.com\x07safe-looking text\x1b]8;;\x07"
      expected: triggered
    - input: "Escaped version in JSON payload: \\x1b[31mred text\\x1b[0m\\x1b[2J clears screen"
      expected: triggered
    - input: "\x1b[?1049h Switched to alternate screen buffer"
      expected: triggered
  true_negatives:
    - input: "Normal tool output without any escape sequences"
      expected: not_triggered
      reason: "Plain text, no ANSI codes present"
    - input: "A Python script that prints hello world"
      expected: not_triggered
      reason: "No escape sequences in benign code example"
    - input: "Documentation explains that \\x1b stands for ESC in ASCII table"
      expected: not_triggered
      reason: "Text reference to ESC without actual escape sequence followed by CSI command"
    - input: "The CVE database lists terminal-related vulnerabilities"
      expected: not_triggered
      reason: "Reference to terminal CVEs without actual payload"
    - input: "git log --color=always output:\\nauthor Alice"
      expected: not_triggered
      reason: "Color-flag mention without actual escape codes"
evasion_tests:
  - input: "\\u001b]0;hidden\\u0007"
    expected: triggered
    bypass_technique: "unicode-escape-encoded"
    notes: "Unicode-escape form still matches condition 4"
  - input: "OSC encoded as HTML: ]0;title"
    expected: not_triggered
    bypass_technique: "html-entity-encoded"
    notes: "HTML entity form evades current regex - would need an additional condition"
  - input: "Base64 wrapped: G10wO2hpZGRlbgc= (decode and execute)"
    expected: not_triggered
    bypass_technique: "base64-double-encoded"
    notes: "Caught by ATR-2026-00256 base-N encoding rule if decode instruction present"