read_fileLABSCO SUMMARY
The sandbox is the product.
Every path resolves under the root you named, with no .. escape, and run_command takes an argv list rather than a shell string — so the interesting decision is not which tools you get but how tightly you draw the boundary. Set AGENT_GODMODE_ALLOWED_COMMANDS and only those binaries can be launched; leave it unset and anything under the sandbox can run.
What it is
A workspace toolkit for building coding agents. It ships five tools — read, write, edit, list and run — every one of them scoped to a single workspace root, and exposes the same operations over MCP and in-process through AgentWorkspace. The model and the API key stay in your application; this package is the execution and sandboxing half.
What you get
- A UTF-8 text file read with an optional line range and byte cap —
read_file - Create, overwrite or append text, with parent directories made for you —
write_file - Search-and-replace in an existing file, where
old_stringmust match exactly once unlessreplace_allis set —edit_file - Directory listings with optional recursion, glob, depth cap and dotfile control —
list_files - A subprocess started from an
argvlist only, never a shell —run_command OPENAI_TOOL_DEFINITIONSandSYSTEM_PROMPT_V1so the same tool shapes can be handed to a chat-completions loop
Requirements
pip install agent-godmode, then run the agent-godmode CLI over stdio. The workspace root is mandatory: set AGENT_GODMODE_ROOT or pass --root. Optional limits are all environment variables — AGENT_GODMODE_MAX_READ_BYTES (default 512000), AGENT_GODMODE_COMMAND_TIMEOUT (default 120), AGENT_GODMODE_MAX_COMMAND_OUTPUT_BYTES (default 256000), AGENT_GODMODE_LIST_MAX_ENTRIES (default 2000) and AGENT_GODMODE_ALLOWED_COMMANDS, a comma-separated list of basenames allowed as argv[0]. The published version is 0.1.9.
Setup effort
One command — pip install agent-godmode
USE CASES
01
Giving your own agent file access
Wire the five tools into a chat-completions loop and let the model read, edit and list files inside one project directory.
02
Letting a model run tests it just changed
Allow only the interpreters you want as argv[0] and let the agent execute them from inside the workspace.
03
Making edits the model must justify
Require the model to copy old_string out of a real read, so an edit that does not match the file on disk fails instead of overwriting it.
04
Using it from Cursor instead of code
Register the stdio server with a workspace root and get the same five tools inside the editor.
5 tools
Listed in project docs. Your client may show a different list.
write_fileedit_filelist_filesrun_commandBEFORE YOU INSTALL
What to know first
Tools you get
5 tools named in the project's documentation.
Requires
agent-godmode on PATH
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install agent-godmodeMCP Clients
Cursor, Any MCP client
JSON
{
"mcpServers": {
"agent-godmode": {
"command": "agent-godmode",
"args": [
"--root",
"D:<YOUR_PROJECT>"
]
}
}
}
