Authentication

Some CLI commands (notably thesis code) require an active session. Sessions are stored locally in the Core SQLite database at ~/.thesis/thesis.db.

If no active session is found, the CLI exits with an error and prints:

  • “No active session found.”
  • “Sign in at https://thesis.ai and open Thesis Desktop to sync your session.”

thesis auth

The auth command currently exposes session inspection only.

thesis auth sessions list

List all sessions known to the local Core API.

thesis auth sessions list [options]

  • Arguments

    • None

  • Options

Option Description Default Required?
--core-url <url> Core API URL http://localhost:42421 No
  • Examples
thesis auth sessions list
thesis auth sessions list --core-url http://localhost:42421
  • Notes
    • This command checks Core API health and will error if it cannot connect.
    • On connection failure it suggests starting the server with thesis server start.

thesis auth sessions get

Get the current session (the latest non-deleted session record).

thesis auth sessions get [options]

  • Arguments

    • None

  • Options

Option Description Default Required?
--core-url <url> Core API URL http://localhost:42421 No
  • Examples
thesis auth sessions get
  • Notes
    • Exits with a non-zero status if no sessions exist or none are active.