Seele Codex npm Package

This package is the prebuilt Linux x64 Seele service. Its backend is the Rust seele-server/seele-worker runtime, statically linked against musl so it does not depend on the target host's glibc version. Node.js 24 LTS and npm are retained for installing and updating the Seele-managed Codex CLI; the target host does not need Rust, pnpm, TypeScript, or Vite.

The web output is path-independent. SEELE_PUBLIC_BASE_PATH selects the public path when the service starts; changing it does not require another build.

Required Deployment Values

Before installation, confirm all of these values with the package owner or target-environment owner. Do not invent or silently default them:

• SEELE_ROOT: persistent root containing .runtime and workspaces.
• SEELE_CODEX_HOST: service listen address.
• SEELE_CODEX_PORT: service listen port.
• SEELE_PUBLIC_BASE_PATH: externally visible path prefix, such as /.
• SEELE_PROXY: local no-auth proxy URL consumed by Codex.
• SEELE_UPSTREAM_PROXY: authenticated upstream proxy URL consumed by gost.
• SEELE_AUTH_PASSWORD: initial admin password for a non-loopback listener.

SEELE_UPSTREAM_PROXY has the form socks5h://username:password@hostname:port. Ask the package owner for the complete secret value. Do not reconstruct it from the example.

Install

Keep npm's cache under the persistent Seele root so later installs and upgrades can reuse downloaded packages:

npm install --global @seele00/seele@latest \
  --registry=https://registry.npmmirror.com/ \
  --cache "$SEELE_ROOT/.runtime/npm-cache"

Copy and edit the environment template:

cp "$(seele env-example)" "$SEELE_ROOT/seele.env"
vi "$SEELE_ROOT/seele.env"

On the first installation, prepare the Seele-managed Codex CLI, authenticate with a headless device code, and start the service:

seele bootstrap \
  --env "$SEELE_ROOT/seele.env" \
  --auth device \
  --start

The command prints a URL and one-time device code. Complete authentication in a browser on another machine. No browser is required on the Linux host.

Start And Upgrade

For normal service starts after bootstrap:

seele start --env "$SEELE_ROOT/seele.env"

Upgrade the npm package without rebuilding Seele on the target host:

npm install --global @seele00/seele@<new-version> \
  --registry=https://registry.npmmirror.com/ \
  --cache "$SEELE_ROOT/.runtime/npm-cache"
seele start --env "$SEELE_ROOT/seele.env"

Package upgrades do not update an existing Codex CLI. Use Seele's runtime settings UI for later Codex CLI updates.