Skip to content

Aethr

Terminal intelligence that learns from your workflow.

Aethr is a local-first CLI tool that provides semantic search over your command history, intelligent error fixing, and shell integration—all without sending data to the cloud.

Install

curl -fsSL https://aethr-ai.dev/install.sh | bash

Then initialize:

aethr init
aethr import

Features

Recall — Search your command history by intent, not exact syntax.

aethr recall "docker build with cache"

Fix — Get instant fixes for terminal errors using a 3-layer resolution system.

aethr fix "permission denied /var/log/app.log"

Auto-save — Automatically capture commands with exit codes, timing, and context.

aethr hook --install

How It Works

Aethr uses SQLite FTS5 for fast, local full-text search. Commands are ranked by:

  • Recency — Recent commands score higher
  • Frequency — Frequently used commands are prioritized
  • Context — Commands matching your current project type get a boost

The fix command uses a 3-layer resolution system:

  1. Deterministic rules — Pattern matching for known errors
  2. Community Brain — Crowdsourced fixes from the community
  3. LLM fallback — AI-powered suggestions (optional, requires API key)

Privacy

All data stays on your machine. There's no telemetry, no cloud sync, no data collection. Your command history is stored locally in ~/.aethr/aethr.db.

Requirements

  • Linux (x86_64) or macOS (Intel/Apple Silicon)
  • Bash or Zsh