Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions docs/tips/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,3 +21,7 @@ short, standalone claude code tips. each one is a specific technique you can use
| [monitor](./monitor.md)

| [monitor](./monitor.md) | watch background processes, react to output in real time (v2.1.98+, stable as of v2.1.145) |

---

| [code-review](./code-review.md) | detect correctness bugs, post as PR comments (v2.1.147+, replaces `/simplify`) |
6 changes: 6 additions & 0 deletions docs/tips/hooks-v2.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,12 @@ hooks come in five flavors now (v2.1.118 added `mcp_tool`). pick the wrong one a





### note on hook conditions with wildcards (v2.1.147+)

v2.1.147 fixed hook `if` conditions. patterns like `PowerShell(git push*)` now match correctly; previously only `PowerShell(*)` worked. if you use wildcard matchers in hook conditions, verify they fire as expected after upgrading.

### effort level in hooks (v2.1.133+)

hooks now receive the active effort setting via two channels:
Expand Down
6 changes: 6 additions & 0 deletions docs/tips/plugins.md
Original file line number Diff line number Diff line change
Expand Up @@ -124,6 +124,12 @@ then anyone can install:

two steps: add the marketplace (once), then install individual plugins from it.



### note on plugin agent type declarations (v2.1.147+)

v2.1.147 fixed a regression where plugin agents declaring multiple `Agent(...)` types in `tools:` frontmatter would drop all but the last entry. if your plugin defines multiple agent types, verify all are recognized after upgrading.

## when to extract a plugin

the signal is copy-pasting. if you're copying the same hook between projects, it's time for a plugin.
Expand Down
5 changes: 5 additions & 0 deletions docs/tips/session-length.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,3 +34,8 @@ shorter sessions are more efficient. here's the data.
run `/mine` to check your own session length distribution. if most of your sessions are 2hr+, you're probably working harder than you need to.

[full cost analysis →](../cost.md)


### note on background sessions (v2.1.147+)

v2.1.147 improved background session management (`Ctrl+T` in `claude agents`). pinned background sessions now stay alive when idle and are restarted in place to apply updates. this may affect session length metrics for users running long-lived background agents. check your actual patterns with `/mine` after upgrading.