Search and retrieve bash command history using Atuin. Use when users ask about commands they've run before, want to find a specific command, recall how they did something previously, or ask "how did I..." or "what command did I use to..."
Installs into .claude/skills of the current project.
Are you the author of Bash History?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/david-li0406-bash-history)
---
name: bash-history
description: Search and retrieve bash command history using Atuin. Use when users ask about commands they've run before, want to find a specific command, recall how they did something previously, or ask "how did I..." or "what command did I use to..."
---
# Bash History Skill
Access bash command history through Atuin to search for and retrieve previously executed commands.
## Tools
### mcp__bash-history__search_history
Search for commands matching a query.
**Parameters:**
- `query` (string): Search term to find matching commands
- `limit` (number, default: 10): Maximum results to return
- `include_failed` (boolean, default: false): Include failed commands
### mcp__bash-history__get_recent_history
Get the most recent commands.
**Parameters:**
- `limit` (number, default: 10): Number of recent commands
- `include_failed` (boolean, default: false): Include failed commands
## Example Usage
When user asks: "How did I deploy last time?"
```
Use mcp__bash-history__search_history with query "deploy"
```
When user asks: "What commands did I run recently?"
```
Use mcp__bash-history__get_recent_history with limit 20
```
When user asks: "Show me failed git commands"
```
Use mcp__bash-history__search_history with query "git" and include_failed true
```
## Output Format
Results include command text, exit code (0 = success), and timestamp. Present clearly and offer to help reuse commands.
