Instantly analyze any error log with AI. Paste it, pipe it, or point to a file — get a diagnosis in seconds.
No dashboards. No accounts. No config. Just answers.
devlog reads any error log and tells you:
- What the error is
- Why it happened
- Where it occurred (file and line if visible)
- How to fix it (step by step)
- How to prevent it happening again
It auto-detects the log format — Python, Node.js, Docker, nginx, GitHub Actions, SQL, Go, Java, and more.
$ devlog error.log
──────────────────────────── devlog ─────────────────────────────
Detected format: Python traceback
Backend: claude
╭────────────────────────── Log Analysis ──────────────────────────╮
│ │
│ ## Error Type │
│ ModuleNotFoundError │
│ │
│ ## Severity │
│ HIGH — application cannot start without this dependency │
│ │
│ ## Root Cause │
│ The package 'requests' is not installed in the active Python │
│ environment. This typically happens when a virtual environment │
│ is active but dependencies haven't been installed into it. │
│ │
│ ## Location │
│ app.py, line 3 │
│ │
│ ## Fix Steps │
│ 1. Activate your virtual environment (if using one) │
│ 2. Run: pip install requests │
│ 3. If using a requirements file: pip install -r requirements.txt │
│ │
│ ## Prevention │
│ Keep requirements.txt updated and always install dependencies │
│ inside your virtual environment before running the project. │
│ │
╰───────────────────────────────────────────────────────────────────╯
# 1. Analyze a log file
devlog error.log
# 2. Pipe output directly — works with any command
cat error.log | devlog
docker logs my-container 2>&1 | devlog
pytest 2>&1 | devlog
npm run build 2>&1 | devlog
# 3. Interactive paste mode — just run devlog with no arguments
devlog
# Paste your log, then press Ctrl+D (Mac/Linux) or Ctrl+Z + Enter (Windows)| Format | Example sources |
|---|---|
| Python traceback | python app.py, pytest, django |
| Node.js / JavaScript | node index.js, npm run, jest |
| Docker container logs | docker logs, docker-compose logs |
| nginx / Apache | Access logs, error logs |
| GitHub Actions / CI | Workflow run output |
| SQL / database errors | PostgreSQL, MySQL, SQLite |
| Java stack traces | Spring Boot, Maven |
| Go panics | go run, go test |
| Generic structured logs | Any ERROR / WARN / FATAL output |
Mac / Linux:
git clone https://github.com/TheChyeahhh/devlog.git
cd devlog
python3 -m venv .venv
source .venv/bin/activate
pip install -e .Windows:
git clone https://github.com/TheChyeahhh/devlog.git
cd devlog
python -m venv .venv
.venv\Scripts\activate
pip install -e .cp .env.example .envOpen .env and add your API key:
ANTHROPIC_API_KEY=sk-ant-your-key-here
OPENAI_API_KEY=sk-your-key-here
AI_BACKEND=claude- Claude key: console.anthropic.com
- OpenAI key: platform.openai.com
devlog error.log # analyze a file
devlog error.log --backend openai # use OpenAI instead of Claude
cat error.log | devlog -b openai # pipe + backend flag- Python 3.9+
- A Claude API key or OpenAI API key
--jsonoutput flag for piping into other tools--watchmode to tail and analyze a live log file- Severity threshold filter (
--min-severity HIGH) - VS Code extension
MIT