CLI reference

jcx is the flagship command; joocode remains a fully compatible alias.

Commands

bash

jcx [--source SOURCE] [--host HOST] [--port PORT]
jcx --all
jcx doctor
jcx models
jcx codex-install [--base-url URL]
jcx serve [--host HOST] [--port PORT]
jcx upgrade [--version VERSION]
jcx hub [--host HOST] [--port PORT]

jcx — start automatic desktop mode and open the dashboard.
jcx --all — force every integration even when its app is not detected.
jcx doctor — check provider discovery and integration health.
jcx models — list the merged model registry.
jcx serve — run only the local proxy without the dashboard.
jcx hub — lightweight remote mode for LAN, VPN, and tailnet use.
jcx start / jcx stop — control the current background session.

Choose a listener

bash

jcx --host 127.0.0.1 --port 10200 \
  --base-url http://127.0.0.1:10200/v1

Binding beyond loopback can expose access to every configured provider. Only do so behind trusted network controls.

Upgrade

bash

jcx upgrade
jcx upgrade --version 0.2.0

All platforms download the matching archive and SHA256SUMS before replacing the executable. Linux and macOS replace the binary atomically; Windows stages a helper that waits for the running process to exit.

Environment variables

A selection of commonly used overrides:

bash

RUST_LOG=joocode=debug,tower_http=debug
JOOCODE_MAX_REQUEST_BYTES=33554432
JOOCODE_STREAM_IDLE_TIMEOUT_SECONDS=120
JOOCODE_RETRY_ATTEMPTS=3
JOOCODE_RETRY_INITIAL_MS=250
JOOCODE_RETRY_MAX_MS=2000
JOOCODE_PROVIDER_CONCURRENCY=8

JOOCODE_CONFIG / JOOCODE_AUTH — override OpenCode config and auth paths.
JOOCODE_PROVIDERS / JOOCODE_COMBOS — custom file locations.
JOOCODE_REPOSITORY / JOOCODE_VERSION — installer overrides.
JOOCODE_API_AUTH_TOKEN / JOOCODE_MANAGEMENT_AUTH_TOKEN — remote admission.

Set RUST_LOG=joocode=debug,tower_http=debug for diagnostics. Joocode does not log secrets or authorization headers.