explaingit

nsankar/aletheia

Analysis updated 2026-05-18

5PythonAudience · researcherComplexity · 2/5LicenseSetup · easy

TLDR

Aletheia is a local AI investigator for Claude Code or OpenAI Codex that checks whether claims are true by weighing noisy evidence and reporting an honest confidence level instead of guessing.

Mindmap

mindmap
  root((Aletheia))
    What it does
      Investigates whether claims are true
      Weighs noisy evidence
      Reports confidence not certainty
    Tech stack
      Python optional
      Claude Code skill
      OpenAI Codex AGENTS.md
    Use cases
      Vet vendor or competitor claims
      Check contractor credentials
      Triage viral science headlines
    Audience
      Claude Code users
      Researchers and investigators
      Founders and PMs

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Check whether a vendor's claimed revenue or customer count holds up against public evidence.

USE CASE 2

Ask whether a company is financially healthy enough to sign a long-term contract with.

USE CASE 3

Investigate whether a competitor's growth or momentum claims are real or overstated.

USE CASE 4

Get an honest inconclusive answer instead of a falsely confident one when evidence is thin.

What is it built with?

PythonClaude CodeOpenAI CodexMermaid

How does it compare?

nsankar/aletheia1ncendium/aibusteraaronmayeux/ha-hurricane-tracker
Stars555
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audienceresearcherops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

No required dependencies, runs locally as a Claude Code skill or via an OpenAI Codex AGENTS.md file.

Use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

In plain English

Aletheia is an AI investigator built to check whether a claim is actually true, rather than just summarizing whatever search results sound the most confident. You might ask it something like whether a company really has the revenue or customer count it claims, and instead of taking the loudest answer at face value, it treats the true answer as hidden and every search result as a noisy clue that only partly reveals it. The core idea is what the project calls an uncertainty loop: form a belief about what is likely true, decide which single piece of evidence would change that belief the most, go look for it, then update the belief based on what was found, including letting contradicting evidence lower its confidence. It keeps repeating this until it is both confident and settled, or it honestly reports that the evidence was inconclusive rather than guessing. The output is a verdict with a plain-English confidence level, the evidence and sources behind it, and whatever remains unresolved. Aletheia runs entirely on your own machine. There is nothing to upload or publish, no required dependencies, and even Python itself is optional since it can fall back to basic arithmetic without it. It is designed to work inside Claude Code or OpenAI Codex, using whichever search tools that agent tool already has available, and support for Claude Cowork is listed as a work in progress. To use it with Claude Code, you clone the repository and copy its skill folder into your local Claude skills directory, then simply ask a plain question in a new chat, since it engages based on intent rather than being called by name. With OpenAI Codex, you point it at the included AGENTS.md file instead. While the shipped examples focus on checking claims about companies, such as vendors or competitors, the README notes the same approach could be pointed at other domains where evidence is noisy and a claim needs checking, like verifying a contractor's credentials or checking whether a viral science headline matches what a study actually found. Doing so mainly means changing what questions it tracks and which sources it trusts. The project is licensed under the MIT License.

Copy-paste prompts

Prompt 1
Using the Aletheia skill in Claude Code, investigate whether Acme's claim of 10,000 paying customers is real.
Prompt 2
Ask Aletheia to assess whether this vendor is financially healthy enough to sign a 3-year contract with.
Prompt 3
Have Aletheia investigate whether our competitor is actually growing or just getting louder online.
Prompt 4
Walk me through copying the Aletheia skill into my Claude Code skills folder so I can start using it.

Frequently asked questions

What is aletheia?

Aletheia is a local AI investigator for Claude Code or OpenAI Codex that checks whether claims are true by weighing noisy evidence and reporting an honest confidence level instead of guessing.

What language is aletheia written in?

Mainly Python. The stack also includes Python, Claude Code, OpenAI Codex.

What license does aletheia use?

Use, modify, and distribute freely, including commercially, as long as you keep the copyright notice.

How hard is aletheia to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is aletheia for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.