Skip to Content
Skip to Content

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

  1. Select a project and task.
  2. Open the terminal, or search for Toggle terminal in the Command Palette. On macOS, press ⌘P.
  3. Confirm that the current directory is the intended project or worktree.
  4. Enter a command and review its output.

Built-in terminal below the conversation with multiple tabs, command output, and a prompt

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.

Request to start a local server and a Permission Required card with Allow Once, Always Allow, and Deny

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.

Last updated on