Troubleshooting

Troubleshooting

pacman: command not found

ATHA targets Arch Linux. Install and run ATHA on Arch-based systems where pacman is available.

Permission denied while writing logs

ATHA writes to /tmp/atha.log when possible, then falls back to user cache:

• $XDG_CACHE_HOME/atha/atha.log
• ~/.cache/atha/atha.log

If log errors still appear, verify the fallback path is writable by your current user.

plan and dry-run look similar

Expected behavior:

• --plan shows decision analysis (what and why).
• --dry-run shows execution simulation (what command would run).

If both outputs look identical, upgrade ATHA and retest:

yay -Syu atha
atha install --plan vim
atha install --dry-run vim

Permission denied (publickey) while pushing to AUR

Add your SSH public key in your AUR account settings, then retry push.

Quick checks:

ssh -T aur@aur.archlinux.org
git remote -v

Color code shows as raw text

Make sure ATHA is executed with bash and update to the latest package version.

If this happens only in one terminal profile, check shell init files and TERM settings.

update exits with error

Run these checks in order:

atha doctor
sudo -v
pacman -V

If dependency checks pass but the issue remains, include the latest log output when reporting:

tail -n 100 /tmp/atha.log
tail -n 100 ~/.cache/atha/atha.log

AUR installs an older version

If AUR index is delayed, local package metadata may appear newer than remote.

Recommended checks:

pacman -Qi atha
yay -Syu atha

If needed, wait a few minutes for AUR indexing and retry.