@iliasalmerekov/aegis
v0.6.1
Published
Terminal proxy that intercepts AI agent shell commands and requires human confirmation before destructive operations
Maintainers
Readme
@iliasalmerekov/aegis
NPM distribution wrapper for Aegis.
npm i -g @iliasalmerekov/aegisThe package downloads the correct Aegis GitHub Release binary for the current
Linux/macOS x64/arm64 host during postinstall, verifies SHA256, and exposes
the aegis command.
NPM installs the binary and never edits .bashrc or .zshrc. As a
convenience, postinstall performs best-effort agent-hook setup: if a
~/.claude or ~/.codex directory already exists, it runs
aegis install-hooks --all. It never creates those directories, and a hook-setup
failure never fails the npm install. Set AEGIS_NPM_SKIP_HOOKS=1 to opt out.
If no agent directory exists yet, install one of the agents and then run:
aegis install-hooks --allClaude Code and Codex command execution is protected through these PreToolUse
hooks, not through setup-shell — those agents ignore a non-bash/zsh $SHELL
in their Bash tool, so only the hook intercepts their commands.
To opt in to shell-proxy mode for tools that launch commands through $SHELL -c:
aegis setup-shellTo undo shell-proxy setup later:
aegis setup-shell --removeNative Windows shells are not supported; use Aegis from WSL2 on Windows.
