Fix¶

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

Basic Usage¶

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

Pass the error message and Aethr will suggest fixes.

The 3-Layer System¶

When you run aethr fix, Aethr checks three sources in order:

Layer 1: Deterministic Rules
    ↓ (no match)
Layer 2: Community Brain
    ↓ (no match)
Layer 3: LLM Fallback (if configured)

The first match wins. This ensures fast, predictable results for common errors.

Layer 1: Deterministic Rules¶

Pattern matching for known errors. Fast, no network required.

Error Pattern	Fix
`permission denied`	`sudo`, `chmod`, `chown` suggestions
`command not found`	Package installation commands
`address already in use`	`lsof -i :PORT`, `kill` commands
`No space left on device`	Disk cleanup commands
`connection refused`	Service status checks

Layer 2: Community Brain¶

Crowdsourced fixes from the community. Stored locally in your database.

When you successfully fix an error, the solution can be shared anonymously to help others. Fixes are vetted and ranked by success rate.

Layer 3: LLM Fallback¶

For novel errors, Aethr can use an LLM to suggest fixes. Requires an API key:

export ANTHROPIC_API_KEY=your-key

LLM calls only happen when Layers 1 and 2 produce no results.

Examples¶

Permission Errors¶

aethr fix "permission denied: /etc/nginx/nginx.conf"

Suggests: - sudo nano /etc/nginx/nginx.conf - sudo chmod 644 /etc/nginx/nginx.conf

Port Conflicts¶

aethr fix "EADDRINUSE: address already in use :::3000"

Suggests: - lsof -i :3000 - kill -9 <PID>

Missing Commands¶

aethr fix "zsh: command not found: node"

Suggests package installation for your OS.

Docker Issues¶

aethr fix "Cannot connect to the Docker daemon"

Suggests: - sudo systemctl start docker - sudo usermod -aG docker $USER

Git Errors¶

aethr fix "fatal: not a git repository"

Suggests: - git init - Navigate to correct directory

Output Format¶

Fix for: permission denied /var/log/app.log

  1. sudo chmod 644 /var/log/app.log
  2. sudo chown $USER:$USER /var/log/app.log

Source: deterministic-rules

The source tells you which layer provided the fix.

Options¶

# Skip LLM fallback
aethr fix "error" --no-llm

# Show all possible fixes
aethr fix "error" --all

Best Practices¶

Include the full error — More context helps matching
Include file paths — Enables specific fix suggestions
Run from project directory — Context improves results