A CLI tool for retrieving and summarizing your work items from Github and Jira over a given time window.

I made this to streamline the process of recalling what I've worked on recently for the purposes of Artsy’s development cycle self-review.

Examples:

./bin/self-review "1 month"
./bin/self-review "q2"
./bin/self-review "first half this year"

The output would start something like this…

…and continue with your actual work items & clusters.

• Determines a time window based on your natural language descriptor ("q2 this year", etc)
• Fetches recent Github PRs authored by you and merged during the time window
• Fetches recent Jira tickets assigned to you and completed during the time window
• Uses an LLM to cluster and summarize these into hopefully coherent groups (YMMV)

The deterministic bit of fetching and listing the relevant PRs and tickets definitely works and could be your own jumping off point if you don't want the LLM summary.

The LLM summaries are hit-or-miss, often differing between runs even over the same time window. Perhaps this could be improved.

Magic is currently applied to natural language time window descriptions, and clustering and summarization of work activity.

You can bypass both with

./bin/self-review fetch --since=2025-07-01

This will only fetch GH and Jira items based on the supplied date in ISO format, and won't bother with any LLM calls.

The results will be dumped to a local yaml file, but the program is not currently optimized for working with that nicely. It could be, though.

./bin/self-review setup # guides you through obtaining and configuring API tokens

./bin/self-review check # confirms your API connections are working

./bin/self-review help # show detailed usage info

./bin/self-review "1 week" # or just start summarizing

See the first commit, which sets up the CLAUDE.md file that largely guided the development of this tool. Mostly Claude working TDD style, with me steering & nudging as needed.