main.js · part 233

60 text occurrences from desktop/Cursor.app/Contents/Resources/app/extensions/cursor-agent-exec/dist/main.js, part 233. Every entry preserves the shipped literal and its saved verdict or selection reason.

File contents and all parts · All files

NEVER use `set -x`; it breaks this tool. If it gets set, run `set +x` to fix the shell.

Optimize for overall cost, including cache reads, cache writes, and output tokens.

Use the 'Workspace Path' field in the `<user_info>` section to resolve the workspace path. It will likely NOT be at `/workspace`; don't waste time trying that.

Still do whatever validation is necessary to ensure the judgment is correct; efficiency means avoiding waste, not skipping verification.

This may still be a long-running investigation if correctness requires it, but do not spend tokens on status updates, progress narration, or UX niceties while judging.

Always quote paths that contain spaces.

Executes a given command in a shell session with optional foreground timeout.

IMPORTANT: Use this tool for terminal operations like git, npm, docker, etc. DO NOT use it for file operations (reading, writing, editing, searching, finding files

) - use the specialized tools for this instead.

 for file operations when applicable. If shell text search is necessary, use `rg`, not `grep` or `find`.

Do not truncate output with `head`, `tail`, or `sed -n` solely to limit its size; large output is saved to a terminal file.

Run independent commands as parallel Shell calls. Chain dependent commands with `&&`.

Use the `gh` command via the 

 tool for all GitHub-related tasks, including issues, pull requests, checks, and releases.

tmux-backed shell sessions

Executes a given command in a shell session with optional foreground timeout.

IMPORTANT: This tool is for terminal operations like git, npm, docker, etc. DO NOT use it for file operations (reading, writing, editing, searching, finding files

) - use the specialized tools for this instead.

Before executing the command, please follow these steps:

Check for Running Processes:

Before starting dev servers or long-running processes that should not be duplicated, search the terminals folder to check if they are already running in existing terminals.

You can use this information to determine which terminal, if any, matches the command you want to run, contains the output from the command you want to inspect, or has changed since you last read them.

Since these are text files, you can read any terminal's contents simply by reading the file

, search using 

Directory Verification:

If the command will create new directories or files, first run ls to verify the parent directory exists and is the correct location

For example, before running "mkdir foo/bar", first run 'ls' to check that "foo" exists and is the intended parent directory

Command Execution:

Always quote file paths that contain spaces with double quotes (e.g., cd "path with spaces/file.txt")

Examples of proper quoting:

cd "/Users/name/My Documents" (correct)

cd /Users/name/My Documents (incorrect - will fail)

python "/path/with spaces/script.py" (correct)

python /path/with spaces/script.py (incorrect - will fail)

Treat the command argument as executable shell text: backticks and `$()` perform command substitution. Quote carefully and avoid command construction that could expose secrets in tool output.

After ensuring proper quoting, execute the command.

Capture the output of the command.

IMPORTANT: Do not run any long-lived processes such as watch commands, dev commands that run forever (like npm run dev for react apps), or anything that is a background process. This makes the conversation hang forever for the user. It is essential to avoid this, and refuse if the user asks you to do so.

Usage notes:

The command argument is required.

The shell starts in the workspace root and is stateful across sequential calls. Current working directory and environment variables persist between calls. Use the `working_directory` parameter to run commands in different directories. Example: to run `npm install` in the `frontend` folder, set `working_directory: "frontend"` rather than using `cd frontend && npm install`.

You can specify an optional timeout in milliseconds (up to 600000ms / 10 minutes). If not specified, commands will timeout after 30000ms (30 seconds).

It is very helpful if you write a clear, concise description of what this command does in 5-10 words.

Avoid using search commands like `find` and `grep`.

Instead prefer 

 to search.

Avoid read tools like `cat`, `head`, and `tail`, and prefer 

 to read files.

 Avoid editing files with tools like `sed` and `awk`, use 

Don't pipe a command's output through `head`, `tail`, or `sed -n` (or similar) just to limit its length — large output is automatically written to a terminal file that you can read in full, so truncating only risks discarding information you need (especially for long-running commands).

If you _still_ need to run `grep`, STOP. ALWAYS USE ripgrep at `rg` first, which all users have pre-installed.

You do not need to use '&' at the end of commands when setting `is_background: true`.

When issuing multiple commands:

If the commands are independent and can run in parallel, make multiple 

tool calls in a single message. For example, if you need to run "git status" and "git diff", send a single message with two 

 tool calls in parallel.

If the commands depend on each other and must run sequentially, use a single

 call with '&&' to chain them together (e.g., `git add . && git commit -m "message" && git push`). For instance, if one operation must complete before another starts (like mkdir before cp,

 for git operations,

or git add before git commit), run these operations sequentially instead.