Recall¶

Search your command history using natural language.

Basic Usage¶

aethr recall "docker build"

Unlike Ctrl+R, you don't need to remember exact syntax. Describe what you're looking for.

Examples¶

# Find Docker commands
aethr recall "build container"
aethr recall "docker compose up"
aethr recall "run postgres locally"

# Find Git operations
aethr recall "merge branch"
aethr recall "undo last commit"
aethr recall "stash changes"

# Find system commands
aethr recall "check disk space"
aethr recall "kill process on port"
aethr recall "compress directory"

How Ranking Works¶

Results are scored by three factors:

Factor	Weight	Description
Recency	40%	Recent commands rank higher
Frequency	30%	Commands you run often rank higher
Context	30%	Commands matching your current project type

Context Awareness¶

Aethr detects your project type and boosts relevant results:

# In a Node.js project (has package.json)
aethr recall "install packages"
# → npm install, yarn add, pnpm install

# In a Python project (has requirements.txt)
aethr recall "install packages"
# → pip install, poetry add

Detected project types:

File	Context
`package.json`	Node.js
`requirements.txt`, `pyproject.toml`	Python
`Cargo.toml`	Rust
`go.mod`	Go
`Dockerfile`	Docker
`Makefile`	Make

Options¶

# Limit results
aethr recall "docker" --limit 5

# Show all matches
aethr recall "docker" --all

Tips¶

Be specific — "docker build nodejs app" finds better results than "build"
Run from project directory — Context detection improves relevance
Import more history — More data means better results

Technical Details¶

Aethr uses SQLite FTS5 (Full-Text Search) for fast, local search. Commands are tokenized and indexed with their metadata (working directory, exit code, timestamp).

The ranking formula:

score = 0.4 × recency + 0.3 × frequency + 0.3 × context

All search happens locally. Nothing leaves your machine.