xeno

A terminal coding agent whose session is a segmented, append-only log. What the model sees is a recomputable projection of that log. Nothing is summarized by a model, and nothing is rewritten in place. A step counts as done only when a command's exit code says so.

Install

npm i -g @visual-z/xeno
xeno --help

npm downloads one native binary for your platform: macOS, Linux (glibc or musl) or Windows, each on arm64 or x64. Neither Node nor Bun is needed to run it.

With Bun, trust the package so its install step can link the binary:

bun add -g --trust @visual-z/xeno

Without --trust, xeno still starts on macOS and Linux through a small launcher script.

Start

export ANTHROPIC_API_KEY=…    # or OPENAI_API_KEY, GEMINI_API_KEY, OPENROUTER_API_KEY, …
xeno                          # interactive
xeno -p "explain this repo"   # one prompt, then exit
xeno -c                       # continue the newest session
xeno -r                       # pick a session to resume

In the app, /provider connects an account, an API key or a gateway. /model switches models, /settings opens settings, /changelog shows what changed, and /update installs a newer release.

Sessions live in .xeno/ inside the project; settings and credentials in ~/.xeno/ (auth.json is created with mode 0600).

Updates

xeno checks the npm registry for a newer release at most once a day, in the background. It sends no identifier. Set XENO_NO_UPDATE_CHECK=1, or turn off Check for updates in /settings, to stop it. xeno update --check checks now.

License

Proprietary (UNLICENSED). You may install and use the published binaries; no right to copy, modify or redistribute them is granted.