Skip to Content
REDCELLDocs

Permissions

Control what RedCell can do on its own and when it must ask you first.

Two settings control what RedCell can do: the sandbox (what's technically allowed) and the approval policy (when it must ask you).

Pick a preset

In the CLI, run /permissions in a session and choose one. In the desktop app, choose the access level in the message box (Read only, Workspace, or Full access).

PresetRedCell can, without askingAsks before
Read OnlyRead files in your projectEditing files, accessing the internet
DefaultRead and edit files in your project, run commandsAccessing the internet, editing files outside your project
Full AccessEverything, including internet access and files anywhereNothing

Most security work needs the network. With Default, expect RedCell to ask before scans and requests. Approve per action, or approve for the session.

Set it from the command line

Use these flags with redcell, redcell exec, or redcell resume.

Sandbox: -s

ValueAllows
read-onlyReading files
workspace-writeReading and editing files in the working folder, running commands
danger-full-accessEverything. No sandbox

Approval policy: -a

ValueRedCell asks
untrustedBefore any command that isn't a known-safe one like ls or cat
on-requestWhen it decides it needs to. This is the default
neverNever. Failures go back to the model instead

For example, edit freely but always ask before anything risky:

redcell -s workspace-write -a untrusted

Allow network access in the sandbox

To let RedCell reach the network without asking each time, while keeping file edits limited to your project, add this to your config:

~/.redcell/config.toml
sandbox_mode = "workspace-write"

[sandbox_workspace_write]
network_access = true

Give access to more folders

Let RedCell write to another folder besides your project:

redcell --add-dir ~/engagements/shared-wordlists

Skip all checks

redcell --dangerously-bypass-approvals-and-sandbox

This turns off the sandbox and all approvals. RedCell can run any command and change any file on your machine. Only use it inside a disposable container or VM.

Make it permanent

Set your defaults in ~/.redcell/config.toml:

~/.redcell/config.toml
sandbox_mode = "workspace-write"
approval_policy = "on-request"

See Configuration.