whatisgithub

What is axiom?

zer0contextlost/axiom — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 2/5Setup · easy

In one sentence

A static analysis tool that finds untested hidden assumptions in your codebase, such as unreleased locks or unchecked nulls, and ranks the riskiest ones.

Mindmap

mindmap
  root((axiom-scan))
    What it does
      Finds hidden assumptions
      Checks test coverage of them
      Ranks risky findings
    Tech stack
      TypeScript
      npm
    Use cases
      CI pipeline checks
      Pull request scans
      Editor integration
    Audience
      Developers
      QA engineers

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

Scan a codebase for null access risks and error swallowing bugs before they hit production.

USE CASE 2

Run axiom-scan on just the files changed in a pull request to catch new risky assumptions.

USE CASE 3

Add axiom-scan to a CI pipeline so risky code changes are flagged automatically.

USE CASE 4

Find concurrency bugs like locks that are taken but never released.

What is it built with?

TypeScriptnpm

How does it compare?

zer0contextlost/axiom0xradioac7iv/tempfsabboskhonov/hermium
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatemoderate
Complexity2/53/54/5
Audiencedeveloperdeveloperdeveloper

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Installs and runs directly via npm, no external infrastructure required.

So what is it?

axiom-scan is a static analysis tool for software developers that finds hidden assumptions in a codebase, assumptions that are never explicitly tested, but that the code quietly relies on to work correctly. Even if your test suite shows 85% line coverage, that does not mean the code is safe: it just means 85% of lines ran during tests. The assumptions behind those lines, such as "this value is never null here," "this database connection is always open first," or "this lock is always released," often go unchallenged until production breaks. axiom-scan reads your source code without running it (static analysis), infers what each piece of code is silently assuming, checks whether any test covers those assumptions, and produces a ranked list of the riskiest bets in your codebase. Findings are organized into categories: null access risks (code accessing a property that could be missing), ordering problems (code reading a value before it is guaranteed to exist), error swallowing (errors caught but silently discarded), concurrency bugs (locks taken but never released), and resource leaks (files or connections opened without a guaranteed close). You would use axiom-scan when you want to find the kind of bugs that only appear in production, after a refactor introduces a new code path, or when a subtle assumption turns out not to hold. It supports eight languages including TypeScript, Python, and Go, and ranks findings by blast radius so the most dangerous gaps surface first. It integrates into CI pipelines and code editors, and can run on just the files changed in a pull request. The tool is written in TypeScript and installed or run directly via npm.

Copy-paste prompts

Prompt 1
Help me install and run axiom-scan on my TypeScript project via npm.
Prompt 2
Explain what a null access risk finding from axiom-scan means and how to fix it.
Prompt 3
Help me wire axiom-scan into my CI pipeline to scan only changed files in a pull request.
Prompt 4
Show me how axiom-scan ranks findings by blast radius.

Frequently asked questions

What is axiom?

A static analysis tool that finds untested hidden assumptions in your codebase, such as unreleased locks or unchecked nulls, and ranks the riskiest ones.

What language is axiom written in?

Mainly TypeScript. The stack also includes TypeScript, npm.

How hard is axiom to set up?

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

Who is axiom for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.