thesis Developers

App

thesis app

Launch the Thesis scientific computing app. This starts the local Core API server in-process, then starts a local static/proxy server that serves the app UI and opens your browser.

thesis app [options]

  • Arguments

    • None

  • Options

Option Description Default Required?
--no-open Do not open a browser automatically Opens browser No
--root-dir <path> Root directory for notebooks Computed default (see Notes) No
--core-url <url> Thesis Core API URL (local server) http://localhost:42421 No
--api-url <url> Override Thesis Cloud API URL (injected into the UI) No
--platform-url <url> Override Thesis Platform URL (injected into the UI) No
--core-token <token> Token to gate the Core API No
  • Examples

Start and open the UI:

thesis app

Use a custom notebooks directory:

thesis app --root-dir ./notebooks

Don't open a browser:

thesis app --no-open

Override injected URLs (useful when pointing the UI at a non-default Cloud API / Platform):

thesis app \
  --api-url https://api.thesis.ai \
  --platform-url https://thesis.ai
  • Notes
    • The Core API runs on port 42421 (from @thesis/common); the frontend proxy listens on the first available port starting at 42420.
    • Cleans up stale ~/.thesis/pids/server.json and kills any process holding the Core API port before starting.
    • Injects a runtime config script into served HTML with NEXT_PUBLIC_THESIS_CORE_URL, NEXT_PUBLIC_THESIS_API_URL, and NEXT_PUBLIC_THESIS_PLATFORM_URL.
    • Registers signal handlers for graceful shutdown of the Core API, frontend server, container, MCP server, and terminal websocket.