Aegis
Claude Code's sandbox lets an agent read your SSH keys and AWS credentials by default. Aegis doesn't.
Two layers, both verified on real hardware.
Kernel sandbox — the agent's own shell cannot reach a denied path:
$ ! cat ~/.ssh/id_rsa
cat: /Users/you/.ssh/id_rsa: Operation not permitted
$ ! cat ~/.aws/credentials
cat: /Users/you/.aws/credentials: Operation not permitted
$ tail ~/Library/Application\ Support/Aegis/denials.log
kernel denied file-read-data /Users/you/.ssh/id_rsa to cat(pid 41560)
kernel denied file-read-data /Users/you/.aws/credentials to cat(pid 42180)
MCP proxy — same tool, same file, with and without Aegis in front:
direct to the server: allowed: TOKEN=proof-env-secret
through aegis proxy: AEGIS DENIED: read_text_file
Reason: path matches deny rule '.env'
Rule: deny_paths
What it does
Sits between your AI coding agent and your machine:
- Deny by default on every tool call
- Kernel sandbox on subprocesses —
cat .envcan't bypass it - Tamper-evident audit log — hash-chained, integrity checked by
aegis doctor, and checkpointed from outside the sandbox under a key the sandbox can't read or write - Outbound requests checked before they're made
- Secrets never reach the MCP server
Install (macOS Apple Silicon)
New here? docs/getting-started.md is the step-by-step path, including the two questions that default to No.
Followed earlier instructions that said aegis-mcp? That package is not Aegis — it is an unrelated
project installed under the same import name, aegis. Remove it first:
python3 -m pip uninstall aegis-mcp
If aegis-sandbox is already installed, that uninstall also deletes two of its files, so reinstall it
afterwards: python3 -m pip install --force-reinstall aegis-sandbox.
python3 -m pip install aegis-sandbox
aegis init # detects Claude Code / Cursor, asks a few questions
aegis doctor # proves the boundary is actually in place
Upgrading? Re-run aegis init. Your policy.json is yours and is never rewritten behind your back, so a
new sandbox domain does not appear on its own — and without the OAuth token endpoint a sandboxed client stops
working when its token expires. aegis init offers the new hosts; accepting is one keystroke.
Prefer an app? Download the .dmg
SHA256: bcccaa957fd3a0a15413eb1207a012f0328e309d078e7b7f2af853915e64c6dc
Unsigned build — right-click the app → Open the first time (macOS will warn about an unidentified developer, that's expected). Or build from source.
What it does NOT do
- Does not stop prompt injection
- Kernel escape defeats the sandbox
- The audit database is still writable from inside the sandbox. Checkpoints make tampering with already-checkpointed history detectable — not impossible, and the newest rows aren't covered yet
- A sandboxed client can't log in at all. Log in to Claude Code before
aegis init;aegis doctorfails if a wrapped client isn't logged in - A sandboxed client can't renew an expired login token — run it once outside the sandbox to refresh
- The sandbox can still read your OAuth token from the Keychain
- Tool results larger than 16 MiB are refused
- No external security review, no certifications
- Not audited by anyone but me — read the source, that's why it's MIT
Full threat model: THREAT-MODEL.md
License
MIT
Metadata
Release files for aegis-sandbox 0.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aegis_sandbox-0.9.0.tar.gz | 169.3 kB | Without provenance | Details for aegis_sandbox-0.9.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aegis_sandbox-0.9.0-py3-none-any.whl | Python 3 | none | any | Details for aegis_sandbox-0.9.0-py3-none-any.whl |
Total release size: 351.8 kB
Release files / aegis_sandbox-0.9.0.tar.gz
| Download URL | aegis_sandbox-0.9.0.tar.gz |
|---|---|
| Size | 169.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6f280919c4db3f063d38009e37a8165e19106fd64a7d4c4a28c16e1b2c512728
|
|
BLAKE2b-256 checksum How to use checksums |
de6c5c821a5ac374499cff767c7dd5e4f22354e518297dfc9eee26dfb8553ccd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.3
|
Release files / aegis_sandbox-0.9.0-py3-none-any.whl
| Download URL | aegis_sandbox-0.9.0-py3-none-any.whl |
|---|---|
| Size | 182.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
358876c4896c64de749706f855bb4be0df50c45758bfbaf256b3ceee0ce32925
|
|
BLAKE2b-256 checksum How to use checksums |
94097941c50c88e3a9f95b0cc00a2bf53926786b7c15e0de1dae859295485f0c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.3
|
Security for aegis-sandbox 0.9.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.