Luminos

Luminos is a file system intelligence tool — a zero-dependency Python CLI that scans a directory and produces a reconnaissance report. With --ai it runs a multi-pass agentic investigation via the Claude API, producing a deep analysis of what the directory contains and why.

Current State

Phase: Active development — core pipeline stable, scaling and domain intelligence planned
Last worked on: 2026-04-06
Last commit: merge: add -x/--exclude flag for directory exclusion
Blocking: None

Quick Links

Page	Contents
Architecture	Module breakdown, data flow, AI pipeline
Internals	Code-level tour: dir loop, cache, prompts, where to make changes
Development Guide	Setup, git workflow, testing, commands
Roadmap	Phase status — pointer to PLAN.md and open issues
Session Retrospectives	Full session history

At a Glance

python3 luminos.py <target>                  # base scan
python3 luminos.py --ai <target>             # AI analysis
python3 luminos.py --ai --refine <target>    # AI + refinement pass (planned)
python3 luminos.py -x .git -x node_modules <target>   # exclude dirs
python3 luminos.py --watch <target>          # continuous monitoring

Repository

https://forgejo.labbity.unbiasedgeek.com/archeious/luminos