Konfigurationsdateien

amoxide speichert seine Konfiguration in ~/.config/amoxide/ als TOML-Dateien. Du musst diese selten manuell bearbeiten — das CLI verwaltet sie — aber das Verständnis des Formats hilft beim Debugging oder Teilen von Setups.

Dateiübersicht

Datei	Zweck
config.toml	Globale Aliase und Shell-Optionen
profiles.toml	Alle Profildefinitionen und deren Aliase
session.toml	Aktive Profilliste (welche Profile gerade aktiv sind)
security.toml	Vertrauensentscheidungen für Projekt-.aliases-Dateien
.aliases	Projektlokale Aliase (liegt im Projektstamm)

config.toml — Globale Konfiguration

# Globale Aliase — immer verfügbar
[aliases]
helo = "echo hello world"
ll = "ls -lha"

# Globale Subcommand-Aliase — Kurzformen für subcommandbasierte Tools
[subcommands]
"jj:ab" = ["abandon"]
"jj:b:l" = ["branch", "list"]

Shell-spezifische Konfiguration

Shell-spezifische Renderoptionen können im Abschnitt [shell.<name>] gesetzt werden.

Fish: [shell.fish]

Schlüssel	Typ	Standard	Beschreibung
use_abbr	bool	false	Einfache Aliase als Fish-Abkürzungen (abbr --add) statt alias ausgeben

[shell.fish]
use_abbr = true

Wenn use_abbr = true gesetzt ist, wird jeder einfache Alias aus allen Ebenen (global, Profil und Projekt) als Abkürzung ausgegeben. Abkürzungen werden beim Tippen direkt expandiert, was den Befehlsverlauf sauber hält.

Parametrisierte Aliase — solche, die {{1}}- oder {{@}}-Platzhalter verwenden — werden immer als function-Definitionen ausgegeben, unabhängig von dieser Einstellung, da Fish-Abkürzungen keine Argumente unterstützen.

Beispielausgabe mit use_abbr = true:

abbr --add gs "git status"
abbr --add ll "ls -lha"

Beispielausgabe für einen parametrisierten Alias (immer eine Funktion, unabhängig von use_abbr):

function cmf
    cm feat: $argv
end

Um diese Einstellung zu aktivieren, bearbeite ~/.config/amoxide/config.toml manuell und füge den oben gezeigten [shell.fish]-Block hinzu. Dann neu initialisieren ohne Neustart, um die Änderung anzuwenden:

am init -f fish | source

config.toml — Update-Prüfung

Steuert die crates.io-Update-Prüfung. Siehe Update-Prüfung für Details.

Schlüssel	Typ	Standard	Beschreibung
check	bool	true	Ob Listing-Befehle crates.io auf eine neuere Version prüfen

[update]
check = false

Du kannst die Prüfung auch pro Aufruf mit der Umgebungsvariable AM_NO_UPDATE_CHECK deaktivieren.

profiles.toml — Profildefinitionen

[[profiles]]
name = "git"

[profiles.aliases]
ga = "git commit --amend"
gcm = "git commit -S --signoff -m"
gst = "git status"

[[profiles]]
name = "rust"

[profiles.aliases]
f = "cargo fmt"
t = "cargo test --all-features"
l = "cargo clippy --locked --all-targets -- -D warnings"

[profiles.subcommands]
"cargo:t" = ["test", "--all-features"]

[[profiles]]
name = "node"

[profiles.aliases]
t = "npm run test"
b = "npm run build"

Jeder [[profiles]]-Block definiert ein benanntes Profil mit seinen Aliasen und optionalen Subcommand-Aliasen. Beachte, dass verschiedene Profile den gleichen Alias-Namen verwenden können (z.B. t in rust und node) — welches Profil höhere Priorität in active_profiles hat, gewinnt.

session.toml — Aktive Profile

Verfolgt, welche Profile aktuell aktiv sind und in welcher Reihenfolge. Wird automatisch von am profile use und am use verwaltet — du musst diese Datei selten direkt bearbeiten.

active_profiles = ["git", "rust"]

Die Reihenfolge bestimmt die Priorität: Der letzte Eintrag hat die höchste Priorität. Wenn sowohl git als auch rust einen Alias mit dem gleichen Namen definieren, gewinnt rust.

security.toml — Vertrauensentscheidungen

Verfolgt, welche Projekt-.aliases-Dateien du überprüft und als vertrauenswürdig markiert hast. Wird automatisch von am trust und am untrust verwaltet — du solltest diese Datei nicht manuell bearbeiten müssen.

[[trusted]]
path = "/home/user/projects/my-app/.aliases"
hash = "a1b2c3d4e5f6..."

[[untrusted]]
path = "/home/user/projects/declined-repo/.aliases"

Jeder vertrauenswürdige Eintrag speichert den Dateipfad und einen BLAKE3-Hash des Inhalts. Wenn sich die Datei ändert, stimmt der Hash nicht mehr überein und amoxide fordert dich auf, sie erneut zu überprüfen. Siehe Vertrauensmodell für Details.

Ein dritter Abschnitt, [[tampered]], erscheint automatisch, wenn eine vertrauenswürdige Datei außerhalb von am geändert wird. Er verschwindet, wenn du am trust ausführst, um die Änderungen zu überprüfen.

.aliases — Projekt-Aliase

Diese Datei liegt im Projektstamm und wird automatisch geladen, wenn du in das Verzeichnis wechselst.

[aliases]
i = "cargo install --path crates/am && cargo install --path crates/am-tui"
l = "cargo clippy --locked --all-targets -- -D warnings"
t = "cargo test --all-features"

[subcommands]
"jj:ab" = ["abandon"]
"jj:b:l" = ["branch", "list"]

Projekt-Aliase überschreiben Profil-Aliase mit dem gleichen Namen. So kannst du Abkürzungen pro Projekt anpassen, ohne dein globales Setup zu ändern.

Prioritätsreihenfolge

Wenn mehrere Ebenen denselben Alias-Namen definieren, gewinnt die spezifischste:

Projekt-Aliase (.aliases)     ← höchste Priorität
  ↑ überschreibt
Aktive Profile (letztes gewinnt)
  ↑ überschreibt
Globale Aliase (config.toml)  ← niedrigste Priorität

Die gleiche Prioritätsreihenfolge gilt für Subcommand-Aliase. Ein [subcommands]-Eintrag in .aliases überschreibt denselben Schlüssel aus einem aktiven Profil, der wiederum denselben Schlüssel in config.toml überschreibt.

Siehe Subcommand-Aliase für Nutzungsbeispiele und wie die Shell-Wrapper generiert werden.