Skip to content

Quick Start

Get up and running in under a minute.

1. Initialize

Create the database and config directory:

aethr init

This creates ~/.aethr/aethr.db for storing your command history.

2. Import History

Import your existing shell history:

aethr import

This reads from ~/.bash_history or ~/.zsh_history and indexes it for semantic search.

3. Set Up Auto-Save

Enable automatic command logging:

aethr hook --install

This adds a hook to your shell config that saves every command with its exit code, duration, and working directory.

Restart your shell or run:

source ~/.bashrc  # or ~/.zshrc

4. Search Your History

Find commands by describing what you want:

aethr recall "docker build"
aethr recall "git rebase"
aethr recall "find large files"

5. Fix Errors

When a command fails, get a fix:

aethr fix "permission denied"
aethr fix "address already in use :3000"
aethr fix "command not found: node"

Interactive Mode

Run aethr without arguments for the interactive interface:

aethr

Use /recall, /fix, /import, /status, or /exit.

Verify Setup

Check everything is working:

aethr status

What's Next