Configuration

Aethr stores configuration in ~/.aethr/config.yaml.

Default Configuration

auto_save: true

Options

auto_save

Enable or disable automatic command logging.

auto_save: true  # or false

When enabled, commands captured by the shell hook are automatically processed and added to the database.

Database

The SQLite database is stored at ~/.aethr/aethr.db.

Schema

command_history — Stores all commands with metadata.

Column	Type	Description
id	INTEGER	Primary key
command	TEXT	The command
working_dir	TEXT	Working directory
exit_code	INTEGER	Exit code (0 = success)
duration_ms	INTEGER	Execution time in ms
timestamp	INTEGER	Unix timestamp
context_tags	TEXT	JSON array of context tags

command_fts — Full-text search index.

Column	Type	Description
command	TEXT	Searchable command text
command_normalized	TEXT	Normalized for matching

community_brain — Crowdsourced fixes.

Column	Type	Description
error_pattern	TEXT	Error to match
fix_command	TEXT	Suggested fix
context_tags	TEXT	Applicable contexts
success_count	INTEGER	Success reports

Environment Variables

Variable	Description
ANTHROPIC_API_KEY	API key for LLM fallback in fix command
AETHR_HOME	Override default config directory (default: ~/.aethr)

Files

Path	Description
~/.aethr/aethr.db	SQLite database
~/.aethr/config.yaml	Configuration file
~/.aethr/commands.log	Temporary log for shell hook
~/.aethr/.token	Authentication token (if logged in)

Reset

To reset Aethr completely:

rm -rf ~/.aethr
aethr init

This deletes all history and configuration. Use with caution.