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).
| Preset | RedCell can, without asking | Asks before |
|---|---|---|
| Read Only | Read files in your project | Editing files, accessing the internet |
| Default | Read and edit files in your project, run commands | Accessing the internet, editing files outside your project |
| Full Access | Everything, including internet access and files anywhere | Nothing |
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
| Value | Allows |
|---|---|
read-only | Reading files |
workspace-write | Reading and editing files in the working folder, running commands |
danger-full-access | Everything. No sandbox |
Approval policy: -a
| Value | RedCell asks |
|---|---|
untrusted | Before any command that isn't a known-safe one like ls or cat |
on-request | When it decides it needs to. This is the default |
never | Never. Failures go back to the model instead |
For example, edit freely but always ask before anything risky:
redcell -s workspace-write -a untrustedAllow 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:
sandbox_mode = "workspace-write"
[sandbox_workspace_write]
network_access = trueGive access to more folders
Let RedCell write to another folder besides your project:
redcell --add-dir ~/engagements/shared-wordlistsSkip all checks
redcell --dangerously-bypass-approvals-and-sandboxThis 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:
sandbox_mode = "workspace-write"
approval_policy = "on-request"See Configuration.