Terminal
Use the built-in terminal to run project commands yourself. Commands run by Aru also appear in the task’s tool results.
Open the terminal
- Select a project and task.
- Open the terminal, or search for Toggle terminal in the Command Palette. On macOS, press ⌘P.
- Confirm that the current directory is the intended project or worktree.
- Enter a command and review its output.

Worktrees use different folders even within one project. Check the location before installing, building, or testing.
Ask Aru to run a command
Describe the goal and, when relevant, the command or scope.
Find out how to run this project and start the local server. Tell me the command and URL.
Run the tests related to my changes and explain any failures.
Review the command and working directory on approval requests. See Permissions and approvals.

Review asynchronous commands
Aru can start a long-running Shell command asynchronously and continue with other work. The command card shows whether it is Running, Complete, Stopped, or Failed. A command may continue in the background after Aru finishes its answer.
Expand the card to review the command, live output, and final result together. Terminal colors and formatting are preserved, and you can copy the command and output separately. For a persistent process such as a server, check its state again and stop it when it is no longer needed.
Stop a command
Long-running terminal processes, such as development servers, usually stop with Ctrl+C; some programs use another method. Stopping Aru’s response does not necessarily stop a terminal or asynchronous command, so check its command card.
Verify the result
Do not treat process exit alone as success. Review errors, test output, generated files, and server availability. Remove passwords and tokens before sharing output with Aru. Inspect file changes in Review changes.