Configuration

The CLI is primarily configured via command flags and a small set of environment variables. There is no thesis.config.json file read by the current CLI.

Defaults

These defaults come from core/src/config.ts:

Setting	Default
Core API port	42421
Jupyter port	8888
Core API URL (--core-url)	http://localhost:42421
Jupyter kernel URL (--jupyter-kernel-url)	http://localhost:8888

Local filesystem paths

The CLI stores local state under ~/.thesis (from THESIS_HOME_DIR):

Path	Purpose
~/.thesis/thesis.db	SQLite database (includes session records)
~/.thesis/pids/*.json	PID files used by thesis server / thesis app for crash recovery
~/.thesis/logs/server.log	Log file used when running thesis server start --detach
~/.thesis/datasets/	Dataset storage directory (used by the Core API)
~/.thesis/models/	Model storage directory (used by the Core API)

Environment variables

THESIS_API_URL

THESIS_API_URL configures the Thesis Cloud API URL used by the agent flows (see core/src/env.ts).

export THESIS_API_URL="http://localhost:8080"

Notes

• Some commands accept --core-url <url> to point at a non-default Core API server.
• thesis app additionally accepts --api-url and --platform-url to override the URLs injected into the app frontend at runtime.