Aeonyx Code

An agentic coding CLI for your terminal. Aeonyx reads your codebase, edits files, runs commands, and works toward a goal — with a permission model that gates every write on every platform, plus an opt-in OS sandbox (kernel-level on Linux via bubblewrap and on macOS via Seatbelt) that confines the commands it runs. Run aeonyx doctor to see the confinement tier on your machine.

Install

npm install -g aeonyxcode

This installs the aeonyx command. The package ships a tiny launcher that runs a prebuilt native binary delivered as an optional, per-platform dependency — only the one matching your OS and CPU is downloaded, so there is no compile step at install time (the same pattern esbuild and Biome use).

Supported platforms:

| OS | Architecture | | ------- | ------------------- | | macOS | Apple Silicon (arm64) | | macOS | Intel (x64) | | Linux | x64 | | Windows | x64 |

On any other platform, install fails closed with a clear message; build from source instead (see the repository).

aeonyx: command not found after install?

The install succeeded, but your npm global bin directory is not on your PATH (common on macOS/Linux with Homebrew node, nvm, or volta). Two ways out:

# Run without touching PATH (also confirms the binary works):
npx aeonyxcode

# Or add npm's global bin to PATH permanently (zsh shown; use ~/.bashrc for bash):
echo "export PATH=\"$(npm prefix -g)/bin:\$PATH\"" >> ~/.zshrc && source ~/.zshrc
aeonyx --help

Usage

# Interactive TUI
aeonyx

# Headless: run one goal and print the result
aeonyx -p "fix the failing test in src/parser.rs"

# Loop mode: iterate toward a goal until a deterministic check passes
aeonyx -p "make the test suite green" --loop

Run aeonyx --help for the full command set.

Configuration

Configuration lives at ~/.config/aeonyx/ (or $XDG_CONFIG_HOME/aeonyx/) on macOS and Linux, and %APPDATA%\aeonyx\ on Windows. Set your provider API key there.

License

Apache-2.0.