DENREE(1)
NAME
denree — an autonomous AI agent that accomplishes a goal by running the terminal's commands, reasoned by a local LLM (WebGPU, 100% in-browser)
SYNOPSIS
denree "<goal in natural language>" denree --commands denree --model <id> "<goal>" denree --steps <n> "<goal>" denree --unload
DESCRIPTION
denree (a nod to "la Denrée", the alien from the film La Soupe aux Choux) is an autonomous agent: you give it a goal and it asks a language model running entirely in your browser (WebGPU, no server) to pick, step by step, which shell command to run. It runs the command, reads its output, feeds that back to the model, and repeats until it produces a final answer.
At each turn the model's decision is constrained to JSON by the engine (grammar-guided generation), so the agent never goes off the rails: it always returns either a command to run or a final answer.
The agent knows the whole command catalog (denree --commands) except the ones with side effects or control flow (rm, su, sudo, msg, open, exit, clear, miaougpt, llm, glaude, denree…), which are blocked for safety.
The model is provided by the central LLM module (see llm and the widget in the top-right corner). By default no model is loaded: denree proposes a reasoning model and asks you to confirm its download — unless a model is already warm (loaded by miaougpt, glaude or llm), which it reuses instantly.
OPTIONS
--commands, --list list the commands the agent may use --model <id> pick the reasoning model (default: Qwen2.5-1.5B) --steps <n> cap the number of agent turns (default: 4) --unload, --stop free the loaded model from GPU memory
EXAMPLES
denree "what is my public IP address and its country?" denree "summarize the file about.md in one sentence" denree --steps 8 "search for the word 'drone' in my documents" denree --model Qwen2.5-3B-Instruct "what's the weather in Rennes?" denree --unload