Let Sypha automatically run terminal commands — tests, builds, and package installs — and feed the results back into its reasoning loop.

Sypha can automatically run terminal commands such as tests, builds, and package installations. Command output is fed back into the assistant in real time, allowing it to validate its changes, diagnose failures, and continue fixing without manual intervention.

How to Enable

Open Settings using the gear icon.
Under Auto-Approve, enable Auto-run Terminal (or Allow Execute).

You can also enable this per-session by approving terminal execution when Sypha first proposes a command, then checking "Always allow" for that action type.

How It Works

Sypha proposes a terminal command as part of completing a task.
With Terminal Automation enabled, the command runs immediately without waiting for your approval.
The full stdout/stderr output is captured and injected back into the conversation.
Sypha reads the output and either confirms the change worked or continues troubleshooting.

This creates a tight feedback loop where Sypha can iteratively run → inspect → fix → repeat, completing tasks that require multiple rounds of trial and error autonomously.

Example Commands Sypha Can Run

# Run the test suite and fix any failures
Run tests and fix failures

# Install a missing dependency and update imports
Install missing dependencies

# Build the project and resolve type errors
npm run build

# Run linting and auto-fix violations
npm run lint --fix

Outcome Loop

Sypha writes code
    → Runs terminal command
        → Reads output
            → Detects failure
                → Fixes code
                    → Re-runs command
                        → Confirms success

This loop continues until the task is complete or Sypha determines it needs your input to proceed.

Common Use Cases

Task	Example Command
Test-driven development	Run tests, fix failures, repeat until green
Dependency management	Install packages, update lock files, resolve peer-dep conflicts
Build verification	Compile, check for type errors, fix them inline
Code quality	Run linters, formatters, and apply fixes automatically
Database migrations	Run migrations and verify schema changes applied cleanly

Safety Considerations

Terminal commands executed by Sypha have the same privileges as your local shell. Before enabling:

Ensure you are working in a project directory, not the system root.
Review what commands Sypha is likely to run for your task.
Use YOLO Mode for fully automated flows, or keep Terminal Automation scoped to specific action types via Auto-Approving Actions.

[!NOTE] On team plans, organisation administrators can restrict Terminal access entirely via Access Control. Individual members only see the Terminal toggle if it has been permitted at the org level.

Terminal Automation