shell-history
Search shell history using atuin. Use when the user mentions searching shell history, finding a past command, or recalling a URL or tool invocation from the terminal.
How do I install this agent skill?
npx skills add https://github.com/gkwa/volcanicviper --skill shell-historyIs this agent skill safe to install?
- Gen Agent Trust Hubwarn
This skill enables searching through terminal command history using the 'atuin' utility. Accessing shell history is inherently sensitive as logs frequently contain accidentally entered credentials, API keys, and private configuration details. The skill also writes this data to temporary files in /tmp, which may pose a local data exposure risk.
- Socketpass
No alerts
- Snykfail
Risk: HIGH · 1 issue
What does this agent skill do?
Shell History Search
When the user wants to find something from their shell history, use atuin with timestamps and grep for filtering.
Standard invocation
atuin search --after "<N> days ago" --format "{time} {command}"
Default <N> is 1.
If the user specifies a day count, use that number instead. Examples that set the day count:
- "search last 2 days of shell history"
- "check 3 days of history"
- "last two days"
This returns all shell commands from the past N days, each prefixed with a timestamp.
Filtering by keyword
Then grep for the relevant term (URL, tool name, flag, etc.).
Run each command as a separate Bash call — never chain with pipes in a single call.
Step 1: capture history to a temp file in the job directory if one is available, otherwise write to a uniquely named file under /tmp.
Step 2: grep that file for the keyword.
Expanding the search window
If nothing useful is found with the default 1-day window, expand incrementally: try 2 days, then 3, and so on — up to 7 days before giving up or asking the user for more context.
Report what window you searched each time so the user knows how far back you looked.
When to use this skill
- User says "check my shell history", "look in my history", "find that command I ran"
- User wants a URL they visited via curl/wget or a tool they ran recently
- User asks what flags or arguments they used for a past command
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/gkwa/volcanicviper/shell-history">View shell-history on skillZs</a>