{
  "title": "Terminal commands",
  "description": "Propose or run shell commands in a project environment.",
  "slug": "terminal",
  "locale": "en",
  "seoTitle": "Terminal command compatibility — Can My Agent Use",
  "socialTitle": "Can my agent run terminal commands?",
  "socialDescription": "Compare terminal command support by exact product surface.",
  "llmSummary": "Terminal command support lets a product propose or execute shell commands in a project environment. Approval, shell, sandbox, working directory, and persistence are qualifiers.",
  "audience": "Engineers comparing chat, desktop, and CLI agent harnesses.",
  "contentKind": "feature",
  "status": "published",
  "tags": [
    "workspace",
    "terminal"
  ],
  "updated": "2026-08-28T00:00:00.000Z",
  "published": "2026-08-28T00:00:00.000Z",
  "category": "tools",
  "summary": "Propose or execute shell commands in a project environment.",
  "specLabel": "Common product term",
  "aliases": [],
  "capabilityKind": "atomic",
  "related": [],
  "relations": [],
  "highlight": true,
  "notes": [
    {
      "id": 1,
      "text": "Evidence checked 2026-08-28: Claude Code documents Bash as a permission-controlled tool and provides CLI modes for agentic command execution."
    },
    {
      "id": 2,
      "text": "Evidence checked 2026-08-28: Cursor Agent documents running terminal commands while completing coding tasks."
    },
    {
      "id": 3,
      "text": "Evidence checked 2026-08-28: OpenAI documents Codex CLI as able to run code and commands locally in the selected directory."
    },
    {
      "id": 4,
      "text": "Evidence checked 2026-08-28: Gemini CLI's official tool reference includes the `run_shell_command` tool with workspace and approval controls."
    },
    {
      "id": 5,
      "text": "Evidence checked 2026-08-28: VS Code documents terminal tools for agent mode, with user-configurable approval and auto-approval behavior."
    },
    {
      "id": 6,
      "text": "Evidence checked 2026-08-28: OpenWork's OpenCode-backed runtime includes shell execution, with permission requests surfaced in the desktop app and policy controlled by the host."
    },
    {
      "id": 7,
      "text": "Evidence checked 2026-08-28: Grok Bot's persistent cloud computer includes a command line and filesystem; local-computer commands are a separate capability controlled by a desktop approval policy."
    },
    {
      "id": 8,
      "text": "Evidence checked 2026-08-28: GitHub Copilot CLI can run shell tools in the current repository or directory, with potentially destructive commands gated by its permission system."
    },
    {
      "id": 9,
      "text": "Evidence checked 2026-08-28: Cline's built-in Bash tool runs commands in a persistent shell session and can be approval-gated by settings or policy."
    },
    {
      "id": 10,
      "text": "Evidence checked 2026-08-28: Continue Agent mode exposes `run_terminal_command`, which runs commands from the workspace root after the tool-permission step unless configured Automatic."
    },
    {
      "id": 11,
      "text": "Evidence checked 2026-08-28: OpenCode's built-in Bash tool lets the model execute shell commands in the project environment, subject to configurable allow, ask, or deny permissions."
    },
    {
      "id": 12,
      "text": "Evidence checked 2026-08-28: Zed's native Agent is documented as able to run code in the project, and its permission system includes a terminal tool."
    },
    {
      "id": 13,
      "text": "Evidence checked 2026-08-28: Warp Agent runs commands and interprets results in the local app; the same agent is also available through Warp Agent CLI."
    },
    {
      "id": 14,
      "text": "Evidence checked 2026-08-28: Devin executes shell commands in its hosted development environment and exposes the complete command history and outputs in the session UI."
    },
    {
      "id": 15,
      "text": "Evidence checked 2026-08-28: Aider includes a user-invoked `/run` command for executing shell commands and optionally adding output to chat, but the cited reference does not establish an autonomous model tool for proposing and running commands."
    }
  ],
  "issues": [],
  "resources": [
    {
      "id": "anthropic-cli-terminal",
      "title": "Anthropic — Claude Code CLI reference",
      "href": "https://docs.anthropic.com/en/docs/claude-code/cli-usage",
      "kind": "docs",
      "publisher": "Anthropic",
      "evidenceType": "documented",
      "reviewedAt": "2026-08-28"
    },
    {
      "id": "cursor-agent-terminal",
      "title": "Cursor — Agent overview",
      "href": "https://cursor.com/docs/agent/overview",
      "kind": "docs",
      "publisher": "Cursor",
      "evidenceType": "documented",
      "reviewedAt": "2026-08-28"
    },
    {
      "id": "openai-codex-terminal",
      "title": "OpenAI — Get started with Codex CLI",
      "href": "https://help.openai.com/en/articles/11096431",
      "kind": "docs",
      "publisher": "OpenAI",
      "evidenceType": "documented",
      "reviewedAt": "2026-08-28"
    },
    {
      "id": "gemini-terminal",
      "title": "Gemini CLI — Tool reference",
      "href": "https://github.com/google-gemini/gemini-cli/blob/main/docs/reference/tools.md",
      "kind": "docs",
      "publisher": "Google",
      "evidenceType": "documented",
      "reviewedAt": "2026-08-28"
    },
    {
      "id": "vscode-terminal",
      "title": "Visual Studio Code — Tools in agents",
      "href": "https://code.visualstudio.com/docs/copilot/concepts/tools",
      "kind": "docs",
      "publisher": "Microsoft",
      "evidenceType": "documented",
      "reviewedAt": "2026-08-28"
    },
    {
      "id": "openwork-terminal",
      "title": "OpenWork — Architecture",
      "href": "https://github.com/different-ai/openwork/blob/dev/ARCHITECTURE.md",
      "kind": "docs",
      "publisher": "OpenWork",
      "evidenceType": "documented",
      "reviewedAt": "2026-08-28"
    },
    {
      "id": "xai-grok-bot-terminal",
      "title": "xAI — Grok Bot computer and apps",
      "href": "https://docs.x.ai/grok-bot/computer-and-apps",
      "kind": "docs",
      "publisher": "xAI",
      "evidenceType": "documented",
      "reviewedAt": "2026-08-28"
    },
    {
      "id": "github-copilot-cli-terminal",
      "title": "GitHub — Allowing and denying tool use in Copilot CLI",
      "href": "https://docs.github.com/en/copilot/how-tos/copilot-cli/use-copilot-cli/allowing-tools",
      "kind": "docs",
      "publisher": "GitHub",
      "evidenceType": "documented",
      "reviewedAt": "2026-08-28"
    },
    {
      "id": "cline-tools-terminal",
      "title": "Cline — Tools reference",
      "href": "https://docs.cline.bot/tools-reference/all-cline-tools",
      "kind": "docs",
      "publisher": "Cline",
      "evidenceType": "documented",
      "reviewedAt": "2026-08-28",
      "locator": "bash"
    },
    {
      "id": "continue-agent-terminal",
      "title": "Continue — How Agent mode works",
      "href": "https://docs.continue.dev/features/agent/how-it-works",
      "kind": "docs",
      "publisher": "Continue",
      "evidenceType": "documented",
      "reviewedAt": "2026-08-28",
      "locator": "What Tools Are Available in Agent Mode"
    },
    {
      "id": "opencode-tools-terminal",
      "title": "OpenCode — Tools",
      "href": "https://opencode.ai/docs/tools/",
      "kind": "docs",
      "publisher": "OpenCode",
      "evidenceType": "documented",
      "reviewedAt": "2026-08-28",
      "locator": "bash"
    },
    {
      "id": "zed-agent-terminal",
      "title": "Zed — AI quick start",
      "href": "https://zed.dev/docs/ai/quick-start",
      "kind": "docs",
      "publisher": "Zed Industries",
      "evidenceType": "documented",
      "reviewedAt": "2026-08-28",
      "locator": "Use the Zed Agent"
    },
    {
      "id": "warp-agent-terminal",
      "title": "Warp — Getting started with Warp",
      "href": "https://docs.warp.dev/",
      "kind": "docs",
      "publisher": "Warp",
      "evidenceType": "documented",
      "reviewedAt": "2026-08-28",
      "locator": "In the Warp app"
    },
    {
      "id": "devin-session-terminal",
      "title": "Devin — Session tools",
      "href": "https://docs.devin.ai/work-with-devin/devin-session-tools",
      "kind": "docs",
      "publisher": "Cognition",
      "evidenceType": "documented",
      "reviewedAt": "2026-08-28",
      "locator": "Shell and Terminal"
    },
    {
      "id": "aider-run-command",
      "title": "Aider — In-chat commands",
      "href": "https://aider.chat/docs/usage/commands.html",
      "kind": "docs",
      "publisher": "Aider",
      "evidenceType": "documented",
      "reviewedAt": "2026-08-28",
      "locator": "/run"
    }
  ],
  "support": [
    {
      "harness": "claude-cli",
      "versions": [
        {
          "track": "current",
          "status": "yes",
          "noteIds": [
            1
          ],
          "target": {
            "kind": "dated-documentation",
            "revision": "current Claude Code CLI documentation",
            "observedAt": "2026-08-28"
          },
          "environmentProfile": "local-default",
          "qualifiers": [],
          "evidence": [
            {
              "resourceId": "anthropic-cli-terminal",
              "type": "documented",
              "observedAt": "2026-08-28"
            }
          ]
        }
      ]
    },
    {
      "harness": "cursor",
      "versions": [
        {
          "track": "current",
          "status": "yes",
          "noteIds": [
            2
          ],
          "target": {
            "kind": "dated-documentation",
            "revision": "current Cursor documentation",
            "observedAt": "2026-08-28"
          },
          "environmentProfile": "local-default",
          "qualifiers": [],
          "evidence": [
            {
              "resourceId": "cursor-agent-terminal",
              "type": "documented",
              "observedAt": "2026-08-28"
            }
          ]
        }
      ]
    },
    {
      "harness": "codex-cli",
      "versions": [
        {
          "track": "current",
          "status": "yes",
          "noteIds": [
            3
          ],
          "target": {
            "kind": "dated-documentation",
            "revision": "current Codex CLI documentation",
            "observedAt": "2026-08-28"
          },
          "environmentProfile": "local-default",
          "qualifiers": [],
          "evidence": [
            {
              "resourceId": "openai-codex-terminal",
              "type": "documented",
              "observedAt": "2026-08-28"
            }
          ]
        }
      ]
    },
    {
      "harness": "gemini-cli",
      "versions": [
        {
          "track": "current",
          "status": "yes",
          "noteIds": [
            4
          ],
          "target": {
            "kind": "dated-documentation",
            "revision": "current Gemini CLI documentation",
            "observedAt": "2026-08-28"
          },
          "environmentProfile": "local-default",
          "qualifiers": [],
          "evidence": [
            {
              "resourceId": "gemini-terminal",
              "type": "documented",
              "observedAt": "2026-08-28"
            }
          ]
        }
      ]
    },
    {
      "harness": "vscode-copilot",
      "versions": [
        {
          "track": "current",
          "status": "yes",
          "noteIds": [
            5
          ],
          "target": {
            "kind": "dated-documentation",
            "revision": "current VS Code documentation",
            "observedAt": "2026-08-28"
          },
          "environmentProfile": "local-default",
          "qualifiers": [],
          "evidence": [
            {
              "resourceId": "vscode-terminal",
              "type": "documented",
              "observedAt": "2026-08-28"
            }
          ]
        }
      ]
    },
    {
      "harness": "copilot-cli",
      "versions": [
        {
          "track": "current",
          "status": "yes",
          "noteIds": [
            8
          ],
          "target": {
            "kind": "dated-documentation",
            "revision": "current GitHub Copilot CLI documentation",
            "observedAt": "2026-08-28"
          },
          "environmentProfile": "local-default",
          "qualifiers": [
            {
              "type": "policy",
              "value": "shell execution is scoped by repository or working-directory permissions and potentially destructive commands require approval unless pre-authorized"
            }
          ],
          "evidence": [
            {
              "resourceId": "github-copilot-cli-terminal",
              "type": "documented",
              "observedAt": "2026-08-28"
            }
          ]
        }
      ]
    },
    {
      "harness": "cline",
      "versions": [
        {
          "track": "current",
          "status": "yes",
          "noteIds": [
            9
          ],
          "target": {
            "kind": "dated-documentation",
            "revision": "current Cline documentation",
            "observedAt": "2026-08-28"
          },
          "environmentProfile": "local-default",
          "qualifiers": [
            {
              "type": "policy",
              "value": "approval, auto-approval, or disablement depends on Cline settings and policy"
            }
          ],
          "evidence": [
            {
              "resourceId": "cline-tools-terminal",
              "type": "documented",
              "observedAt": "2026-08-28"
            }
          ]
        }
      ]
    },
    {
      "harness": "continue",
      "versions": [
        {
          "track": "current",
          "status": "yes",
          "noteIds": [
            10
          ],
          "target": {
            "kind": "dated-documentation",
            "revision": "current Continue documentation",
            "observedAt": "2026-08-28"
          },
          "environmentProfile": "local-default",
          "qualifiers": [
            {
              "type": "policy",
              "value": "terminal execution is available in Agent mode, not read-only Plan mode, and depends on model tool-use support and tool policy"
            }
          ],
          "evidence": [
            {
              "resourceId": "continue-agent-terminal",
              "type": "documented",
              "observedAt": "2026-08-28"
            }
          ]
        }
      ]
    },
    {
      "harness": "opencode",
      "versions": [
        {
          "track": "current",
          "status": "yes",
          "noteIds": [
            11
          ],
          "target": {
            "kind": "dated-documentation",
            "revision": "current OpenCode documentation",
            "observedAt": "2026-08-28"
          },
          "environmentProfile": "local-default",
          "qualifiers": [
            {
              "type": "policy",
              "value": "the Bash tool can be allowed, approval-gated, or denied through permission rules"
            }
          ],
          "evidence": [
            {
              "resourceId": "opencode-tools-terminal",
              "type": "documented",
              "observedAt": "2026-08-28"
            }
          ]
        }
      ]
    },
    {
      "harness": "zed-agent",
      "versions": [
        {
          "track": "current",
          "status": "yes",
          "noteIds": [
            12
          ],
          "target": {
            "kind": "dated-documentation",
            "revision": "current Zed documentation",
            "observedAt": "2026-08-28"
          },
          "environmentProfile": "local-default",
          "qualifiers": [
            {
              "type": "policy",
              "value": "terminal calls remain subject to Zed Agent profiles, tool permissions, and workspace trust"
            }
          ],
          "evidence": [
            {
              "resourceId": "zed-agent-terminal",
              "type": "documented",
              "observedAt": "2026-08-28"
            }
          ]
        }
      ]
    },
    {
      "harness": "warp",
      "versions": [
        {
          "track": "current",
          "status": "yes",
          "noteIds": [
            13
          ],
          "target": {
            "kind": "dated-documentation",
            "revision": "current Warp documentation",
            "observedAt": "2026-08-28"
          },
          "environmentProfile": "local-default",
          "qualifiers": [
            {
              "type": "policy",
              "value": "the local Agent documents review and approval controls before actions execute"
            }
          ],
          "evidence": [
            {
              "resourceId": "warp-agent-terminal",
              "type": "documented",
              "observedAt": "2026-08-28"
            }
          ]
        }
      ]
    },
    {
      "harness": "devin-web",
      "versions": [
        {
          "track": "current",
          "status": "yes",
          "noteIds": [
            14
          ],
          "target": {
            "kind": "hosted-observation",
            "revision": "2026-08-28 Devin documentation observation",
            "observedAt": "2026-08-28"
          },
          "environmentProfile": "hosted-default",
          "qualifiers": [
            {
              "type": "runtime",
              "value": "commands run in Devin's hosted development environment rather than the operator's local terminal"
            }
          ],
          "evidence": [
            {
              "resourceId": "devin-session-terminal",
              "type": "documented",
              "observedAt": "2026-08-28"
            }
          ]
        }
      ]
    },
    {
      "harness": "aider",
      "versions": [
        {
          "track": "current",
          "status": "partial",
          "noteIds": [
            15
          ],
          "target": {
            "kind": "dated-documentation",
            "revision": "current Aider documentation",
            "observedAt": "2026-08-28"
          },
          "environmentProfile": "local-default",
          "qualifiers": [
            {
              "type": "runtime",
              "value": "the documented /run command is invoked by the person; this evidence does not establish an autonomous agent shell tool"
            }
          ],
          "evidence": [
            {
              "resourceId": "aider-run-command",
              "type": "documented",
              "observedAt": "2026-08-28"
            }
          ]
        }
      ]
    },
    {
      "harness": "openwork-desktop",
      "versions": [
        {
          "track": "current",
          "status": "yes",
          "noteIds": [
            6
          ],
          "target": {
            "kind": "dated-documentation",
            "revision": "current OpenWork architecture documentation",
            "observedAt": "2026-08-28"
          },
          "environmentProfile": "local-default",
          "qualifiers": [
            {
              "type": "policy",
              "value": "shell execution remains subject to OpenWork and OpenCode permission rules"
            }
          ],
          "evidence": [
            {
              "resourceId": "openwork-terminal",
              "type": "documented",
              "observedAt": "2026-08-28"
            }
          ]
        }
      ]
    },
    {
      "harness": "grok-bot-desktop",
      "versions": [
        {
          "track": "current",
          "status": "yes",
          "noteIds": [
            7
          ],
          "target": {
            "kind": "hosted-observation",
            "revision": "2026-08-28 Grok Bot desktop documentation observation",
            "observedAt": "2026-08-28"
          },
          "environmentProfile": "hosted-default",
          "qualifiers": [
            {
              "type": "runtime",
              "value": "commands run on the account-scoped hosted computer by default; credentials and files there are shared across the account's Bots"
            },
            {
              "type": "policy",
              "value": "commands on the operator's local Mac or Windows computer are separately controlled and default to asking every time"
            }
          ],
          "evidence": [
            {
              "resourceId": "xai-grok-bot-terminal",
              "type": "documented",
              "observedAt": "2026-08-28"
            }
          ]
        }
      ]
    }
  ],
  "html": "/features/terminal",
  "markdown": "/features/terminal.md",
  "json": "/api/v1/features/terminal.json",
  "body": "This capability covers a built-in, permissioned route for an agent to propose or execute shell commands in its working environment. It does not claim unattended execution, access beyond the selected workspace, a particular shell, or identical approval behavior.\n\nOnly current product documentation is used here. Preview tracks and unreviewed surfaces remain unknown."
}