From 75e3dc124c767d0252cbffaae21ff603bbcaa4d4 Mon Sep 17 00:00:00 2001
From: Ellie Huxtable <ellie@atuin.sh>
Date: Mon, 13 Apr 2026 21:42:05 +0100
Subject: feat: autoinstall ai shell history hooks (#3399)

Follows our existing behaviour of automatically installing shell hooks,
extend this for ai agents too

## Checks
- [ ] I am happy for maintainers to push small adjustments to this PR,
to speed up the review cycle
- [ ] I have checked that there are no existing pull requests for the
same thing
---
 docs/docs/guide/agent-hooks.md | 25 +++++++++----------------
 1 file changed, 9 insertions(+), 16 deletions(-)

(limited to 'docs')

diff --git a/docs/docs/guide/agent-hooks.md b/docs/docs/guide/agent-hooks.md
index cefeb155..0801e819 100644
--- a/docs/docs/guide/agent-hooks.md
+++ b/docs/docs/guide/agent-hooks.md
@@ -42,15 +42,11 @@ Only `Bash` tool invocations are captured. Other tool types (file writes, web fe
 
 By default, Atuin's interactive search shows only your own commands. Agent-run commands are hidden so they don't clutter your history.
 
-This is controlled by the `search.authors` setting in `~/.config/atuin/config.toml`:
+Today this default is built into the search UI rather than configurable via `config.toml`. Interactive search uses the equivalent of:
 
-```toml
-[search]
-# Default: only show commands from human users
-authors = ["$all-user"]
-```
+- `$all-user` — any author that is **not** a known AI agent
 
-### Special filter values
+For explicit author filtering, use the CLI `atuin search --author ...` flag. Special values:
 
 | Value | Meaning |
 |-------|---------|
@@ -59,22 +55,19 @@ authors = ["$all-user"]
 
 You can also use literal author names:
 
-```toml
-[search]
+```shell
 # Show only your own commands and Claude Code commands
-authors = ["$all-user", "claude-code"]
+atuin search --author '$all-user' --author 'claude-code' -- ''
 ```
 
-```toml
-[search]
+```shell
 # Show everything (no filtering)
-authors = []
+atuin search -- ''
 ```
 
-```toml
-[search]
+```shell
 # Show only agent commands
-authors = ["$all-agent"]
+atuin search --author '$all-agent' -- ''
 ```
 
 Currently recognized agent names are: `claude-code`, `codex`, `copilot`, and `pi`.
-- 
cgit v1.3.1