THOTH

Getting started

Thoth analyzes your uncommitted Git change, estimates the blast radius, runs the project's own relevant checks, and produces an honest report of what was verified and what was not.

Requirements

  • —Node.js ≥ 22.12
  • —Git
  • —A TypeScript or JavaScript repository
  • —macOS or Linux (Windows is not supported yet)

Install

npm install -g @openthoth/cli

Or without installing, via npx @openthoth/cli <command>.

First run

cd your-project
thoth init

init detects the package manager, language, test runner and verification scripts, then writes a minimal .thoth/config.json plus a .thoth/.gitignore so runtime data never pollutes Git. It never touches your own .gitignore.

The flow

# 1. Edit some code (or let your AI agent edit it)
# 2. See what the change reaches
thoth impact

# 3. Run the relevant verification and get a report
thoth verify

# 4. Review the saved report later
thoth report

If verify prints VERIFIED WITH LIMITATIONS or NOT VERIFIED, the report lists exactly which changed files or symbols have no evidence — that list is the point of the tool, not noise.

JSON output

Every command supports --json for scripting. Output carries schemaVersion: 1; treat fields as additive-only within a major schema version.