agent-retro — плагин для Claude Code: отчёт и установка
Плагин agent-retro для Claude Code и Codex собирает недельное ретро из 12 слайдов со статистикой и четырьмя подсказками по промптам для разбора собственных привычек.
MIT ★ 1 596 обновлён 2026-10-29
/plugin marketplace add hashgraph-online/awesome-codex-plugins
/plugin install agent-retro@awesome-codex-pluginsЧто делает agent-retro
agent-retro собирает локальные логи Claude Code и Codex, а также экспорты ChatGPT или claude.ai из ~/Downloads. На выходе получается ретро из 12 анимированных слайдов: 8 статистических показателей о токенах, проектах и привычках и 4 подсказки по промптам, связанные с этими данными. Результат открывается по приватной ссылке, если агент умеет публиковать страницы, или сохраняется как локальный HTML-файл.
Команда /agent-retro:retro строит отчёт за неделю. Можно выбрать источники через only=codex, задать период days=14, попросить инструкции для истории ChatGPT или показать справку. Файлы и предыдущие отчёты сохраняются в ~/agent-retro/; путь меняется через AGENT_RETRO_HOME. При малом числе промптов или оценённых реакций отчёт будет коротким и без коучинга и архетипа.
Данные читаются локально, а в модель отправляется обезличенная выжимка промптов. Скрипты скрывают ключи, токены, учётные данные, адреса электронной почты и другие чувствительные строки. Без macOS или Linux и доступного python3 плагин не запустится.
Какие задачи решает
- собрать недельную статистику по логам Claude Code и Codex
- сравнить привычки работы с агентами по прошлым отчётам
- найти промпты, после которых задача была принята или исправлена
- получить подсказки по формулировке следующих запросов
Примеры запросов агенту
- Запусти
/agent-retro:retroи собери моё ретро за эту неделю. - Запусти
/agent-retro:retro only=codex days=14по логам Codex за 14 дней. - Покажи через
/agent-retro:retro chatgpt, как добавить историю ChatGPT.
Как установить agent-retro
Через маркетплейс плагинов
/plugin marketplace add hashgraph-online/awesome-codex-plugins/plugin install agent-retro@awesome-codex-pluginsПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы об agent-retro
Как установить agent-retro в Claude Code?
Выполните /plugin marketplace add hashgraph-online/awesome-codex-plugins и затем /plugin install agent-retro@awesome-codex-plugins.
Что делает agent-retro?
Плагин превращает логи Claude Code и Codex в недельное ретро из 12 слайдов со статистикой и четырьмя подсказками по промптам. Отчёт сохраняется локально или публикуется как приватная страница.
Какие требования есть у agent-retro?
Нужны macOS или Linux и доступный python3. Для подсчёта данных агенту может понадобиться разрешение на чтение ~/.claude, ~/.codex, ~/Downloads и запись в ~/agent-retro.
Исходный текст
agent-retro · MIT
# Agent Retro
A weekly look back at how you use AI coding agents. It's 12 animated slides: **8 fun stats** about your week (tokens, projects, habits, your archetype), with **4 bite-sized coaching tips** woven in, each right after the stat it comes from. The tips show what's working and one small thing to try.
## Install
The same plugin folder works in Claude Code and in Codex (the Codex CLI, or Codex in the ChatGPT desktop app). Each install step takes a local folder (such as `~/Downloads/agent-retro`), a GitHub `owner/repo`, or a git URL.
**Claude Code**
```
/plugin marketplace add <path-or-git-url-of-this-folder>
/plugin install agent-retro@agent-retro
```
From a terminal, the same two steps are `claude plugin marketplace add …` and `claude plugin install agent-retro@agent-retro`.
**Codex / ChatGPT**
```
codex plugin marketplace add <path-or-git-url-of-this-folder>
codex plugin add agent-retro@agent-retro
```
## Use
In Claude Code, run `/retro` (or `/agent-retro:retro` if another plugin also has a `/retro`). In Codex, ask for it ("build my Agent Retro") or mention the skill, `$agent-retro:retro`. Options go after the command or in the same message:
| Option | What it does |
|---|---|
| *(none)* | Build this week's Retro from every source it finds: Claude Code and Codex logs on your machine, plus any ChatGPT or claude.ai export in `~/Downloads` |
| `only=codex` | Use only the listed sources (comma-separated: `claude-code`, `codex`, `chatgpt`, `claude-ai`) |
| `days=14` | Look back 14 days instead of 7 |
| `chatgpt` | Ways to add your ChatGPT history, with prompts you can paste |
| `help` | Show the options |
With fewer than eight human prompts or eight judged reactions, you get a short factual recap with no coaching or archetype.
It takes a few minutes. You get a private link if your agent can publish pages, or a local HTML file otherwise. Everything is saved in `~/agent-retro/`, so next week's Retro can compare against this one and rotate in new slides. Set `AGENT_RETRO_HOME` to use a different folder.
If Codex's sandbox blocks reading `~/.claude`, `~/.codex` or `~/Downloads`, or writing to `~/agent-retro`, approve the request when it asks. The Retro needs those folders to count your week and remember past ones.
## Privacy
- **Everything is read locally:** `~/.claude/projects`, `~/.codex`, and export zips you put in Downloads.
- **Your agent sees redacted text only.** It reads a redacted digest of your prompts to write the deck, and sends that to its model provider as it would for any other task. Nothing else leaves your machine, except the finished deck if you publish it as a *private* page that only you can open until you share it.
- **Sensitive text stays out of the deck.** Quotes are short. Before the deck writer sees your prompts, the scripts redact API keys, tokens, private keys, credentials in URLs, password-like strings, emails, phone and card numbers, and your home-folder name.
- **Raw prompt text stays in memory.** Preparation creates a unique private build directory and writes only redacted measurements. Interrupted runs do not leave raw transcript files.
## How the coaching works
After each prompt, the Retro looks at your *next* message. "OK, now…", "let's build that" or "great" counts as landed. "That's not…", "why didn't you…" or "stop" counts as a course-correction. It compares prompts that did something (set a boundary, said what done looks like, shared the why) with those that didn't, and explains the pattern using well-known prompting practices. These are signals, not grades. Every tip is framed as "even better", never "wrong".
Requires macOS or Linux, with `python3` available.
© Matt Herz · MIT · hashgraph-online/awesome-codex-plugins