What did my agents run today? A daily note for a friend who lives in the terminal, written by Gemma 4 on his own laptop
说明与用途
whatran 自动处理编码代理的命令历史,标记危险操作,并生成简洁、经过模型验证的摘要,帮助开发者快速了解代理每天的工作。
问题
Coding agents execute shell commands that are recorded but not easily understood; users need a concise daily summary of what agents did, where, and any risky actions.
结果
whatran provides a daily, verified summary of coding agents’ terminal activity, flagging risky commands and explaining them in plain language, improving transparency and security for developers who rely on agents.
工作流
- 1. Install atuin hook for Claude Code:
atuin hook install claude-code. 2. Run agents; their commands are recorded in atuin and Claude Code session files. 3. Executewhatran --db demo/history.db --since 2dto generate the daily report. 4. whatran parses the SQLite database and session files, applies regex rules to flag risky commands. 5. The tool counts commands per agent/project, identifies failures, and extracts intent from session descriptions. 6. Gemma 4 model (served by Ollama) receives JSON facts and writes a concise paragraph per flagged event. 7. The note is cross‑checked against facts; if any mismatch, the note is suppressed and only counts/flags are shown. 8. The final report is displayed to the user, highlighting where agents worked, what deserves a second look, and a plain‑English explanation of each flagged action.
证据
whatran reads that history once a day and answers three questions: Where did the agents work? What deserves a second look? What was the agent trying to do?
The commands those agents run are recorded, and nobody reads them. atuin can now capture what an agent runs (atuin hook install claude-code), tagged with the agent's name, and then it hides those entries from search by default so they don't clutter your own history.
Gemma 4 wrote the note in about 11 seconds on my laptop: ... In plain words (gemma4:12b, running on this machine) ...
whatran is Python with no dependencies of its own: sqlite3 and urllib from the standard library.
- 记录日期: 2026-10-02T22:40:52.809Z