Who it is forA developer who wants agent help on files without giving a model free rein on the disk.
The problemGeneral agents can touch anything and are hard to audit afterwards.
The outcomeAn agent confined to one workspace, with every run recorded in SQLite.
What you need first
- Python 3.11
- Ollama (README example pulls qwen3.5:9b) or a Chat Completions-compatible API
Steps
- Clone with
git clone https://github.com/MuzeAnisichael/minimal-local-agent.gitand create a Python 3.11 venv - Install with
python -m pip install -e .and pull a model withollama pull qwen3.5:9b - Copy the config with
cp agent.example.toml agent.tomland runminimal-agent doctor - Open the console with
minimal-agent weband give it a task
Prompt for your agent
Set up MuzeAnisichael/minimal-local-agent with Ollama, run `minimal-agent doctor`, then ask it to summarize the files in <workspace>. Confirm the run appears in the local SQLite audit history and no file changed.
Caveat. Web tasks can only read or preview; approving an actual write requires the interactive CLI.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for MuzeAnisichael/minimal-local-agent and "Run a local agent on one sandboxed folder"
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeShare: X LinkedIn Hacker News Email Copy link
Third-party repos we don't own. AI-written use cases can be wrong. Disclaimer