[PR #440] docs(codex): document sandbox_mode requirement for file writes #436

New issue

Open

opened 2026-10-26 09:49:18 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-26 09:49:18 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/deepseek-ai/awesome-deepseek-agent/pull/440
Author: @fhgffy
Created: 10/4/2026
Status: 🔄 Open

Base: main ← Head: docs/codex-sandbox-mode

📝 Commits (2)

4cd371a docs(codex): document sandbox_mode requirement for file writes
c24a8c1 docs(codex): clarify effective sandbox mode and top-level settings

📊 Changes

2 files changed (+42 additions, -0 deletions)

View changed files

📝 docs/codex.md (+21 -0)
📝 docs/codex.zh-CN.md (+21 -0)

📄 Description

Add matching English and Chinese instructions for allowing Codex to write project files in a read-only session. Put sandbox_mode = "workspace-write" at the TOML top level, before any table sections; restart the session and check /status, or choose the mode at CLI launch.

The guide also explains that launch options and workspace trust affect the effective mode, so an unset key does not always imply read-only access. Protected paths and managed policies may still restrict writes, and regenerating the config removes manually added settings. The permission guidance is based on the official Codex sandbox documentation.

Validation: parsed the sandbox snippets with Python's TOML parser, checked both translations and their links, and checked UTF-8 encoding and whitespace. No live Codex permission test was run.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/deepseek-ai/awesome-deepseek-agent/pull/440 **Author:** [@fhgffy](https://github.com/fhgffy) **Created:** 10/4/2026 **Status:** 🔄 Open **Base:** `main` ← **Head:** `docs/codex-sandbox-mode` --- ### 📝 Commits (2) - [`4cd371a`](https://github.com/deepseek-ai/awesome-deepseek-agent/commit/4cd371a793ec7cf73a80726c0b1305218b3a93d3) docs(codex): document sandbox_mode requirement for file writes - [`c24a8c1`](https://github.com/deepseek-ai/awesome-deepseek-agent/commit/c24a8c1fbd81fecef884ac84d1ed7a89add4b005) docs(codex): clarify effective sandbox mode and top-level settings ### 📊 Changes **2 files changed** (+42 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `docs/codex.md` (+21 -0) 📝 `docs/codex.zh-CN.md` (+21 -0) </details> ### 📄 Description Add matching English and Chinese instructions for allowing Codex to write project files in a read-only session. Put `sandbox_mode = "workspace-write"` at the TOML top level, before any table sections; restart the session and check `/status`, or choose the mode at CLI launch. The guide also explains that launch options and workspace trust affect the effective mode, so an unset key does not always imply read-only access. Protected paths and managed policies may still restrict writes, and regenerating the config removes manually added settings. The permission guidance is based on the [official Codex sandbox documentation](https://learn.chatgpt.com/docs/agent-approvals-security). Validation: parsed the sandbox snippets with Python's TOML parser, checked both translations and their links, and checked UTF-8 encoding and whitespace. No live Codex permission test was run. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi added the

pull-request

label

2026-10-26 09:49:18 +00:00

No labels

pull-request

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

deepseek-ai/awesome-deepseek-agent#436

No description provided.

Rows
Columns