auto-agent watches your codebase while you work. It finds TODOs, flags stale PRs, and posts comments, without interrupting your flow.
Ticks every 5 minutes, reads everything, speaks only when it has something useful to say.
Scans git history, TODOs/FIXMEs/HACKs, dangling imports, never-imported files, and missing env keys across 10 languages: Python, JS, TS, Go, Rust, Java, and more.
Reads system idle time on Mac, Windows, and Linux. Sends a desktop notification when you're away, a quiet terminal line when you're present.
Monitors open PRs for staleness, missing reviews, and conflicts. Posts comments autonomously when autonomy is high, once per PR per day, never spammy.
Every night at midnight, the day's observations are consolidated by an LLM into per-topic memory files. Context persists and improves across sessions.
FastAPI dashboard at localhost:8000 shows autonomy level, action feed, open PRs, memory topics, and today's log. Light and dark mode. Approve PRs and trigger ticks from the browser.
Every action is logged to SQLite and deduplicated per day. The same observation won't surface twice.
Requires Python 3.10+, a Groq API key, and a GitHub personal access token.
git clone https://github.com/nandanadileep/auto-agent.git cd auto-agent python3 -m venv .venv && source .venv/bin/activate pip install -r requirements.txt
Copy the example and fill in your keys.
cp .env.example .env
| Key | Description | |
|---|---|---|
| GITHUB_TOKEN | required | Personal access token with repo scope |
| GITHUB_REPO | required | Default repo for webhook setup, e.g. username/repo |
| GROQ_API_KEY | required | From console.groq.com, free tier works |
| GOOGLE_AI_STUDIO_KEY | required | From aistudio.google.com, used for AutoDream |
| OLLAMA_BASE_URL | optional | Defaults to http://localhost:11434 |
| GITHUB_WEBHOOK_SECRET | optional | Secret for webhook HMAC verification |
| NGROK_AUTHTOKEN | optional | Enables real-time GitHub webhook tunnel via ngrok |
| DEMO_MODE | optional | Set to true for 1-min ticks and verbose output |
python3 main.py
Dashboard opens at http://localhost:8000. auto-agent runs silently in the background. A line prints only when it has something to say.