// Reference
Watcher & Auto-Fix
Run Uneven Agent in the background watching your dev server or test suite. The moment an error appears, it diagnoses and prepares a fix automatically. Configure everything from the chat with /fix.
How it Works
Start the watcher from your terminal pointing at any long-running command. Uneven Agent reads its output in real time and acts the moment something breaks:
uneven watch --cmd "npm run dev" uneven watch --cmd "pytest --watch" uneven watch --cmd "cargo test"
Every fix applied is logged to .uneven/log.md with the file, line, diff, and recommendation — so you always know what changed and why.
/fix — Configure the Watcher
All watcher settings are managed from the chat using /fix. No config files needed. Run it without arguments to open the interactive menu:
/fix # interactive menu: # ▶ Terminal Command: npm run dev (Click to change) # ▶ Directories to Watch/Fix: ./src ./lib (Click to change) # ▶ Auto Fix: false (Toggle) # ▶ Confirm Before Fix: true (Toggle) # ▶ Save and Exit # ▶ Cancel / Exit
| Setting | What it controls |
|---|---|
| Terminal Command | The command the watcher monitors (e.g. npm run dev, pytest) |
| Directories to Watch/Fix | Which directories the agent is allowed to read and patch (e.g. ./src ./lib) |
| Auto Fix | When on, patches are applied automatically. When off, the fix is only suggested. |
| Confirm Before Fix | When on, the agent asks for your approval before writing any change to disk |
/fix <setting> — Inline Shortcuts
Update individual settings directly without opening the menu:
# Set which command to watch /fix terminal npm run dev /fix terminal cargo test # Set which directories to monitor /fix dirs ./src ./app ./lib # Enable or disable automatic patching /fix autofix true /fix autofix false # Require confirmation before applying any fix /fix confirm true /fix confirm false
Auto-Fix vs Suggest
| Mode | What happens when an error is detected |
|---|---|
autofix false | The agent prints the diagnosis and suggested fix in the chat. You apply it manually. |
autofix true + confirm true | The agent prepares the patch and asks your approval before writing to disk. |
autofix true + confirm false | The agent detects, diagnoses, and applies the patch automatically — fully hands-free. |
Start with
autofix false to get familiar with how the watcher behaves, then enable auto-fix once you trust the suggestions for your project.