code.ae

A sovereign coding CLI. Keyless sign-in, durable project memory, data-residency controls, and shared sessions — with the codeae command on your PATH.

Install

One line, no gotchas:

# Windows (PowerShell)
irm https://code.ae/install.ps1 | iex

# macOS / Linux
curl -fsSL https://code.ae/install.sh | sh

Or straight from npm:

npm install -g codeae-cli@latest --force

(--force overwrites the codeae bin shim, so re-running to update never fails with EEXIST. Once installed, codeae upgrade updates for you.)

The codeae command lands on your PATH. Works in PowerShell, cmd, and any POSIX shell.

Use codeae-cli (not @code.ae/cli) on Windows: PowerShell treats a leading @ as its splatting operator, so npm i -g @code.ae/cli errors. codeae-cli is the same CLI under a plain name. (@code.ae/cli also works if you quote it: npm i -g "@code.ae/cli".)

Troubleshooting

• npm.ps1 cannot be loaded ... running scripts is disabled — your PowerShell blocks all scripts (npm included). Fix it once: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned, then re-run the install. (Or install from cmd.exe instead of PowerShell.)
• code E404 on @code-ae/... — the package is @code.ae/cli (a dot, not a hyphen), or just use codeae-cli.
• EEXIST … codeae.ps1 … file already exists — a leftover bin shim from a previous install. Add --force: npm install -g codeae-cli@latest --force.

Use

codeae login          # sign in (OAuth, no API key)
codeae                # start / resume a session in the current folder
codeae run "<task>"   # run one task and exit
codeae doctor         # check install, auth, connectivity
codeae --help         # all commands

What you get

• Keyless OAuth sign-in — no API keys to manage; codeae login and go.
• Multi-account profiles — codeae profile use <name> to switch accounts.
• Durable memory + project floor — verified facts and decisions persist across sessions and survive context compaction.
• Data-residency egress control — MCP tools are deny-by-default; you allow only the servers you trust with CODEAE_MCP_ALLOW.
• Scoped project rules — .codeae/rules/*.md with @include and per-file globs, on top of native AGENTS.md.
• Local usage meter — codeae usage (private; never leaves your machine).
• Cross-device handoff — codeae handoff export / import to continue a session on another machine.

Requirements

Node.js 18+. The platform engine is installed automatically for your OS.

© code.ae