pi-atuin

Atuin-style fuzzy history search for pi. Press ↑ for interactive history.

Packages

Package details

extension

Install pi-atuin from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-atuin
Package
pi-atuin
Version
0.1.8
Published
Jul 6, 2026
Downloads
1,231/mo · 31/wk
Author
alexandre_ai
License
MIT
Types
extension
Size
465.4 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ],
  "image": "https://raw.githubusercontent.com/RealAlexandreAI/pi-atuin/master/screenshot.png"
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-atuin

Atuin-style fuzzy history search for Pi

Press ↑ to search previous prompts with fuzzy matching. Backed by atuin DB + local JSONL.

Install

pi install npm:pi-atuin

Or from source:

git clone https://github.com/RealAlexandreAI/pi-atuin.git
cd pi-atuin && pi install .

Setup

Full atuin integration (recommended)

# Install atuin (if not already)
curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh

# Register / login
atuin register -u <username> -e <email>

pi-atuin records history into atuin automatically — no atuin hook install pi needed. That hook registers a conflicting bash tool and breaks extensions like pi-tool-display.

If you previously ran atuin hook install pi, remove the hook extension:

rm ~/.pi/agent/extensions/atuin.ts
pi /reload

With atuin installed, history syncs bidirectionally. Search in either pi (↑) or your shell (atuin search).

JSONL-only (no atuin)

No setup needed. Pi prompts are stored in ~/.pi/agent/pi-history.jsonl.

What gets recorded

Source JSONL (↑ search) Atuin DB
Your pi prompts Yes Yes
Agent bash tool calls No Yes (default on)
Your ! shell commands No Yes
  • Prompts always go to JSONL and atuin (when installed).
  • Agent bash is recorded to atuin only (not mixed into ↑ prompt search). On by default; /atuin record-agent-history toggles it.
  • ! commands are your direct shell input in pi — tracked in atuin, not JSONL.

Usage

History search

  1. Press ↑ when the input is empty
  2. Type to fuzzy-filter
  3. ↑↓ to navigate, Enter to select, Esc to cancel

Commands

/atuin record-agent-history   # toggle agent bash → atuin, shows on/off

Settings persist in ~/.pi/agent/extensions/pi-atuin/config.json.

Privacy

  • History file permissions: 600 (owner-only)
  • Max 1,000 JSONL entries, auto-trimmed
  • Atuin calls use execFile / pi.exec (no shell injection)
  • No hardcoded credentials or keys

License

MIT

Built for Pi Coding Agent. Inspired by atuin.