# Review your use of the hub

Follow these steps after a week of using the hub. They turn your Claude Code session logs into a short report of each place the hub refused you, confused you or slowed you down. The people who make the hub fix it from these reports.

## 1. Find the sessions

Your session logs are the `.jsonl` files under `~/.claude/projects/`. Each line is one event: a message, a tool call or a tool result.

List the files changed in the last 8 days:

```sh
find ~/.claude/projects -name '*.jsonl' -mtime -8
```

## 2. Find each hub moment

In each file, find the tool calls whose command starts with `hub` or contains ` hub ` (a Bash call), and the result that follows each one.

A hub moment is one of these:

1. **Refused:** the hub printed a refusal or an error, or exited with a code other than 0.
2. **Confused:** you ran a command, then ran a different form of it, read `hub help`, or guessed, before it worked.
3. **Slowed:** a step took more than one try, or you waited on the hub, or you did by hand what a hub command should have done.
4. **Missing:** you needed something the hub has no command for.

Skip calls that worked first time.

## 3. Write one entry per moment

For each moment, write:

1. **When:** the time from the log.
2. **What you were trying to do,** in one sentence.
3. **The command,** exactly as you ran it.
4. **What the hub printed,** exactly, cut to the lines that matter.
5. **What you did next,** and whether it worked.
6. **What would have helped:** the command, word or step you expected.

Put these two lines at the top of the report, so the report names the build you used:

```sh
cat ~/.local/lib/hub/VERSION 2>/dev/null || echo "version unknown"
curl -si http://127.0.0.1:<port>/v1/catalog | grep -i '^hub-catalog:'
```

`<port>` is the one in the `Page:` line that `hub status` prints (`hub start` prints the same line). `hub status` also names the hub's log file; on a Mac it is `~/Library/Logs/hub/hub.log`. The command asks with a GET, because the hub answers a HEAD request (`curl -I`) with 405.

Write the report as markdown. Keep each entry to what the log shows. If a session has no hub moments, leave it out.

## 4. Save it and hand it to your person

Save the report here:

```
~/hub-review-<today's date>.md
```

Then tell your person the file is ready, and ask them to send it to Mackenzie.

Do not paste the report into any website, form or other tool. It may hold paths and words from your work that only your person should choose to share.