Skip to content
View UseTruth's full-sized avatar
🎯
Focusing
🎯
Focusing

Block or report UseTruth

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
usetruth/README.md

UseTruth Public React App

React/Vite public app for usetruth.ai.

Positioning

UseTruth helps AI, security, and risk teams clear high-stakes AI actions before they reach real systems.

Current public wedge:

  • Clearance: pre-action gate for agent/tool actions.
  • Evidence: public preview for checking source evidence, freshness, and missing proof.
  • Defensibility record: public concept for the outcome of a review, with implementation details kept private.

Public Routes

  • /: clearance-first product overview.
  • /clearance.html: public Clearance preview and action-gate workflow.
  • /meridian.html: public evidence review preview.
  • /console.html: public UseTruth Console access preview.
  • /use-cases.html: buyer and user workflow fit.
  • /trust.html: trust, privacy, review, and audit principles.
  • /developers.html: reviewed developer access posture.
  • /agents.html: authority-before-action patterns.
  • /news.html: public release notes and research updates.
  • /owner-optout.html: owner-only exclusion request page.

The route .html files in the source root are compatibility shells that load the React app. The production build also copies index.html to each historical route so direct links keep working on static hosting.

Private Material

Private backend, schemas, SDKs, internal strategy, deployment notes, and agent instructions are local development assets. They are not part of the public static release unless a later legal, security, and IP review explicitly approves publication.

The public package guard blocks release artifacts that include private directories, internal documents, credentials, AWS ARNs, secret-looking values, or deployment scripts.

Local Preview

Start the Vite dev server with the bundled Codex Node runtime:

cd C:\Users\User\Documents\usetruth-ai-prototype
C:\Users\User\.cache\codex-runtimes\codex-primary-runtime\dependencies\node\bin\node.exe C:\Users\User\.cache\codex-runtimes\codex-primary-runtime\dependencies\node\node_modules\pnpm\bin\pnpm.cjs --dir . install
C:\Users\User\.cache\codex-runtimes\codex-primary-runtime\dependencies\node\bin\node.exe .\node_modules\vite\bin\vite.js --host 127.0.0.1 --port 4178

Then open:

http://127.0.0.1:4178/

Public Build

Build the reviewed public React package:

cd C:\Users\User\Documents\usetruth-ai-prototype
powershell -ExecutionPolicy Bypass -File .\scripts\build_react_public_package.ps1

The build script installs dependencies with the bundled runtime, runs Vite, copies historical route shells, and runs scripts\assert_public_artifact.ps1 before zip creation.

Expected output:

C:\Users\User\Documents\usetruth-ai-prototype\usetruth-ai-react-v43-clearance-first-20260617.zip

Deployment

Deploy the reviewed package to the existing Amplify prod branch:

cd C:\Users\User\Documents\usetruth-ai-prototype
powershell -ExecutionPolicy Bypass -File .\deploy_usetruth_v3_amplify.ps1

After deployment, verify:

  • https://usetruth.ai/ loads the UseTruth React app.
  • https://usetruth.ai/clearance.html loads the Clearance preview.
  • private paths such as /api, /schemas, /sdk, /internal, /backend, README.md, and AGENTS.md return 404.

Release Discipline

Public copy can name the concepts: Clearance, evidence, freshness, missing proof, owner review, final verdict, audit trail, and human review.

Public copy must not expose scoring thresholds, complete schemas, backend logic, private SDK contracts, integration details, IAM policy details, partner workflows, or patent strategy before review.

Popular repositories Loading

  1. usetruth usetruth Public

    AI clearance layer for high-stakes AI outputs and agent actions.

    JavaScript

  2. drafts drafts Public

    Forked from VeritasActa/drafts

    IETF Internet-Drafts for the Veritas Acta protocol: signed receipts, knowledge units, and restraint/adherence artifacts

  3. usetruth-enforcer usetruth-enforcer Public

    Deny-by-default enforcer for UseTruth signed verdicts. Put an independent, offline-verifiable ES256 clearance in front of any AI agent, in about 5 lines.

    Python

  4. receipt-example receipt-example Public

    A real UseTruth refusal, signed in production, that you can verify yourself in under a minute. No account, no trust required.

    Python

  5. clearance-sandbox clearance-sandbox Public

    Throwaway repo for testing GitHub deployment protection rule behaviour