Skip to main content

Command approval

Seqera AI CLI is in beta

Seqera AI CLI is currently in beta. Features and commands may change as we continue to improve the product.

note

Seqera Cloud users receive $20 in free credits to get started with Seqera AI. Contact us for additional credits.

Seqera AI can execute local commands and edit files in your environment. This page explains approval modes that control which operations run automatically versus which require your permission, including dangerous commands, workspace boundaries, and best practices.

Approval prompts

When a command requires approval, you will see output similar to:

The assistant wants to run:
rm -rf ./build/

[A]pprove [R]eject [E]dit

You can:

  • Approve (A): Run the command as shown
  • Reject (R): Cancel the command
  • Edit (E): Modify the command before running

Approval modes

Approval modes control which local commands Seqera AI can execute automatically and which require your explicit approval. This provides a balance between convenience and safety when working with local files and commands.

There are three approval modes:

ModeDescriptionBest for
basicOnly safe, read-only commands run automaticallyMaximum security
defaultSafe commands and workspace file edits run automaticallyTypical development
fullEverything except dangerous commands runs automaticallyExperienced users

Basic

Rule: Only safe, read-only commands run automatically. Everything else requires approval.

This is the most restrictive mode. The assistant can only auto-execute commands that view information without making changes.

Auto-executes:

  • cat - View file contents
  • ls - List directory contents
  • pwd - Show current directory
  • head - View file beginning
  • tail - View file end
  • tree - Display directory tree
  • echo - Print text (without file redirection)
  • date - Show current date/time
  • whoami - Show current user
  • env - Display environment variables
  • printenv - Print environment variables
  • stat - Show file status
  • uptime - Show system uptime

Requires approval: All other commands, including file edits, directory creation, and any other command execution. Safe commands that include file redirections (e.g., echo "hello" > file.txt) also require approval.

Use when: You want maximum control and visibility over every action the assistant takes.

Examples:

> Create a new file called test.txt with "hello world"

The assistant wants to create file:
./test.txt

[A]pprove [R]eject [E]dit

Default

Rule: Safe commands and file operations within your workspace run automatically. All other commands require approval.

This is the recommended mode for most users. It allows productive workflow while protecting system files and preventing destructive operations.

Auto-executes:

  • All safe commands from basic mode (without file redirections)
  • File edits within your current workspace:
    • Creating files (touch, file creation)
    • Editing files (text modifications)
    • Creating directories (mkdir)
    • Copying files (cp within workspace)
    • Moving files (mv within workspace)

Requires approval:

  • File operations outside your workspace
  • All dangerous commands (see below)
  • Commands with file redirects to paths outside workspace
  • All other commands (e.g., curl, wget, git, npm, python, etc.)

Use when: You're doing typical development work and want convenience without compromising safety.

Examples:

> Create a new file called test.txt with "hello world"

Created ./test.txt

File creation in the workspace runs automatically.

> Edit /etc/hosts

The assistant wants to edit file:
/etc/hosts

[A]pprove [R]eject [E]dit

Editing outside the workspace requires approval.

Full

Rule: Everything runs automatically except explicitly dangerous commands.

This is the most permissive mode. Use it when you fully trust the assistant's actions and want minimal interruption.

Auto-executes: All commands except those on the dangerous list.

Requires approval: Only dangerous commands (see below).

Use when: You're an experienced user comfortable with automated command execution, or when working in an isolated/disposable environment.

Dangerous commands

These commands always require approval in any mode:

CommandRisk
rmDelete files/directories
chmodChange file permissions
chownChange file ownership
killTerminate processes
killallTerminate multiple processes
pkillKill processes by name
sudoExecute as superuser
ddLow-level data operations
mountMount filesystems
umountUnmount filesystems
mkfsCreate filesystems
rebootRestart system
shutdownPower off system

Examples:

> Create files and directories as needed

Created ./src/utils.py
Created ./tests/test_utils.py
Created ./config/settings.json

Most operations run without prompts.

> Delete the build directory

The assistant wants to run:
rm -rf ./build/

[A]pprove [R]eject [E]dit

Dangerous commands still require approval.

Workspace boundaries

In default mode, the "workspace" is your current working directory and its subdirectories. File operations are evaluated as:

  • Inside workspace: /path/to/workspace/src/file.txt - auto-executes
  • Outside workspace: /etc/config or ~/other-project/file.txt - requires approval

The workspace is set when you start the assistant:

# Workspace is /home/user/my-project
cd /home/user/my-project
seqera ai

# Or explicitly set the workspace
seqera ai -w /home/user/my-project

Best practices

  • Start with default mode: It provides a good balance for most workflows
  • Use basic mode for unfamiliar projects: When exploring new codebases
  • Reserve full mode for trusted contexts: Disposable environments or well-understood tasks
  • Review dangerous command prompts carefully: These commands can have significant impact

Learn more