Skip to content

Commands

Complete reference for all Aethr CLI commands.

Overview

aethr [COMMAND] [OPTIONS]

Run aethr without arguments for interactive mode.

init

Initialize Aethr database and configuration.

aethr init

Creates:

  • ~/.aethr/aethr.db — SQLite database for command history
  • ~/.aethr/config.yaml — Configuration file

Run this once after installation.

import

Import existing shell history into the database.

aethr import

Reads from:

  • ~/.bash_history (Bash)
  • ~/.zsh_history (Zsh)
  • ~/.aethr/commands.log (auto-saved commands)

Shows a progress spinner while importing.

recall

Search your command history using natural language.

aethr recall <query>

Arguments:

  • query — Natural language search query

Examples:

aethr recall "docker build"
aethr recall "git merge conflict"
aethr recall "find large files"

fix

Get fixes for terminal errors.

aethr fix <error>

Arguments:

  • error — Error message text

Examples:

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

Uses the 3-layer resolution system: deterministic rules → Community Brain → LLM fallback.

hook

Manage shell integration for automatic command logging.

aethr hook [shell] [--install]

Arguments:

  • shell — Shell type: bash or zsh (auto-detected if omitted)

Options:

  • --install — Add hook to shell config file

Examples:

# Install hook automatically
aethr hook --install

# Print hook for manual installation
aethr hook bash
aethr hook zsh

login

Authenticate with your Aethr token.

aethr login <token>

Arguments:

  • token — Your authentication token

Get a token from console.aethr-ai.dev.

status

Check Aethr configuration and status.

aethr status

Shows:

  • Database location and size
  • Command count
  • Auto-save status
  • Authentication status

Interactive Mode

Run aethr without arguments:

aethr

Available commands in interactive mode:

Command Description
/recall <query> Search command history
/fix <error> Fix an error
/import Import shell history
/init Initialize database
/status Show status
/login <token> Authenticate
/help Show help
/exit Exit

Global Options

Option Description
-h, --help Print help
-V, --version Print version