Skip to main content

Troubleshooting

aegis: command not found​

The installer writes the launcher to ~/.local/bin/aegis by default.

Add that directory to PATH:

export PATH="$HOME/.local/bin:$PATH"

Then open a new shell.

Python is too old​

The public installer currently expects Python 3.12 or newer. Check it with:

python3 --version

If your default python3 is older, rerun the installer with a newer interpreter:

curl -fsSL https://aegis.agentic-in.ai/install.sh | bash -s -- --python /path/to/python3.12

aegis status says the provider is not ready​

Usually this means the expected secret environment variable is not exported in your current shell. Re-export it, then rerun:

aegis status

I need to rewrite the launcher​

For the public install path:

curl -fsSL https://aegis.agentic-in.ai/install.sh | bash -s -- upgrade

For a repo checkout:

bash scripts/install.sh upgrade

I want to inspect the durable layout​

Default locations:

  • runtime root: ~/.aegis
  • state: ~/.aegis/state
  • profile: ~/.aegis/profile
  • skills: ~/.aegis/skills
  • installed skills: ~/.aegis/skills/installed
  • authored skills: ~/.aegis/skills/authored
  • built-in skills: shipped inside the installed package under packages/skills/builtin_packages/

That is where Aegis keeps the durable local posture between sessions. Built-in skills do not need to appear under ~/.aegis/skills unless you explicitly install or author local copies.