whatisgithub

What is mindlas?

evolutionairy-ai/mindlas — explained in plain English

Analysis updated 2026-05-18

26PythonAudience · developerComplexity · 3/5Setup · easy

In one sentence

A local tool that watches your AI coding assistant during long sessions and warns you when its work drifts off track, measuring four specific failure modes and applying targeted corrections.

Mindmap

mindmap
  root((repo))
    What it does
      Watches AI coding sessions live
      Warns when work drifts off track
      Applies targeted corrections
      Runs fully locally
    Failure modes
      Context Rot tracking
      Verification Debt detection
      Change Blast Radius measuring
      Tool Failure Loop detecting
    Tech stack
      Python 3.11 plus
      Git
      Claude Code integration
    Use cases
      Long AI coding sessions
      Catching unchecked code changes
      Exporting session scorecards
    Audience
      AI coding tool users
      Developers using agents
    Setup
      Clone and run demo
      Plugin or CLI install
      Hooks and status line

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

Monitor a long AI coding session and get alerted when the assistant starts drifting from the original task.

USE CASE 2

Catch code changes that were never actually verified or tested during an agent session.

USE CASE 3

Detect when the same tool keeps failing repeatedly and break the failure loop.

USE CASE 4

Export a scorecard showing what went wrong and how corrections improved the session.

What is it built with?

PythonGitClaude Code

How does it compare?

evolutionairy-ai/mindlas95ge/cfquantaevella/sky-pc-mcp-companion
Stars262626
LanguagePythonPythonPython
Setup difficultyeasymoderatemoderate
Complexity3/53/53/5
Audiencedeveloperdevelopervibe coder

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

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Python 3.11 or newer, git, and Claude Code installed, two install paths available (plugin or CLI).

So what is it?

Mindlas watches your AI coding assistant during long sessions and warns you when its work starts going off track. The idea is simple: a coding agent rarely fails right away. It fails slowly, dozens of turns in, as the conversation fills with noise and the original task gets lost. Mindlas reads the session live, spots that drift building up, and hands the agent a specific correction. Everything runs locally on your machine, so none of your code or session data ever leaves. The tool watches four specific problems. Context Rot tracks when the working context deteriorates, not just when the window is full. Verification Debt catches code changes that were never actually checked. Change Blast Radius measures when edits spread too far across files. Tool Failure Loop detects when the same tool keeps failing repeatedly. Each problem has one gauge and one paired correction. The gauges run on a simple loop: measure, trigger, explain, correct, remeasure, and report. Scoring is deterministic. The same session data always produces the same score, with no AI model grading another model's work and no network calls involved. Corrections change state directly rather than just prompting the agent to fix itself, which the developers found did not work in practice. Every correction records a before and after measurement to prove it did something. Setup takes about a minute if you have Python 3.11 or newer, git, and Claude Code installed. You can clone the repository and run a demo command to see a simulated alert and watch a correction bring a score from 100 down to 4. For live use, you install hooks that record session events and a status line that shows the gauges under your prompt. There are two install paths, a plugin option and a CLI option, and you pick one. Mindlas is honest about its limits. It does not guarantee correctness, prevent hallucinations, replace tests, or know what the model is thinking. Its claim is narrow: detect known deterioration causes from local signals, apply corrections, record the effects, and produce a scorecard you can export. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
I have Claude Code installed and Python 3.11. Help me clone the Mindlas repo and run the demo command to see a simulated alert and correction in action.
Prompt 2
Set up Mindlas hooks for my live Claude Code sessions so I can see the four gauges under my prompt and get corrections when context rot or verification debt builds up.
Prompt 3
My AI coding assistant keeps editing files across the whole project and losing track of the original task. Help me use Mindlas to measure Change Blast Radius and Context Rot, then apply corrections.
Prompt 4
I want to export a Mindlas scorecard after a long agent session to review what went wrong and whether the corrections actually improved the scores.
Prompt 5
Help me choose between the Mindlas plugin install path and the CLI install path, and set up the status line that shows the gauges under my prompt.

Frequently asked questions

What is mindlas?

A local tool that watches your AI coding assistant during long sessions and warns you when its work drifts off track, measuring four specific failure modes and applying targeted corrections.

What language is mindlas written in?

Mainly Python. The stack also includes Python, Git, Claude Code.

How hard is mindlas to set up?

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

Who is mindlas for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.