nxtg-atlas

Portfolio intelligence for AI engineering teams.

Scan your repos. Score health. Find cross-project patterns nobody else sees.

pip install nxtg-atlas

The Problem

You manage 5, 10, 20+ repos. Every tool on the market — Cursor, Copilot, Claude Code — works inside a single repo. Nobody sees the full picture:

• Which repos have zero tests?
• Are your React versions consistent across projects?
• Where are you duplicating FastAPI patterns instead of sharing them?
• Which repos haven't been touched in weeks?

You don't know until something breaks.

The Solution

atlas init --name "My Portfolio"
atlas add ~/projects/api
atlas add ~/projects/frontend
atlas add ~/projects/ml-pipeline
atlas scan
atlas status

30 seconds. Full portfolio health dashboard. Real data from your repos.

What You Get

╭───────────────────────  ATLAS Portfolio Dashboard  ─────────────────────────╮
│                                                                             │
│  Portfolio: NXTG.AI  |  8 Projects  |  609 Test Files  |  1,251,303 LOC    │
│  Health: B (82%)  |  Scanned: 2026-03-04T01:15                             │
│                                                                             │
╰─────────────────────────────────────────────────────────────────────────────╯
┌────┬────────────────────┬──────────┬────────┬──────────┬─────────────────────┐
│    │ Project            │ Health   │  Tests │      LOC │ Tech Stack          │
├────┼────────────────────┼──────────┼────────┼──────────┼─────────────────────┤
│ ●  │ Dx3                │  A 94%   │    179 │  164,806 │ Python · TypeScript │
│ ●  │ content-engine     │  B+ 88%  │     23 │   12,552 │ Python              │
│ ●  │ Podcast-Pipeline   │  B+ 88%  │     49 │   33,680 │ Python · FastAPI    │
│ ●  │ nxtg.ai            │  B+ 87%  │     36 │   49,938 │ TypeScript · Next.js│
│ ●  │ Faultline          │  B+ 86%  │     29 │   15,527 │ TypeScript · React  │
│ ●  │ voice-jib-jab      │  B+ 86%  │     58 │   45,311 │ TypeScript · Python │
│ ●  │ SynApps            │  C 67%   │    114 │  793,406 │ Python · TypeScript │
│ ●  │ NXTG-Forge         │  D 59%   │    121 │  136,083 │ TypeScript · Rust   │
└────┴────────────────────┴──────────┴────────┴──────────┴─────────────────────┘

This is real output from scanning 8 production repos. Not a mockup.

Features

• Health scoring — 4 dimensions (tests, git hygiene, documentation, structure) → A-F grade
• Tech stack detection — Python, TypeScript, Rust, Go, Java + frameworks (FastAPI, React, Next.js, Django, etc.)
• Git health — branch, commit count, dirty state, remote status
• Database detection — PostgreSQL, SQLite, Redis, MongoDB, pgvector
• Cross-project intelligence — shared deps, version mismatches, health gaps
• Batch add — atlas batch-add ~/projects adds every repo at once
• Export — markdown and JSON reports for stakeholders
• Unlimited projects — no limits, no tiers, no gates

Everything is free. Everything is open source. No catches.

What It Detects

Health Score Breakdown

Each project scores 0-100% across 4 dimensions:

  Health Breakdown:
    Tests          █████████████░░  90%
    Git Hygiene    ██████████████░  99%
    Documentation  ███████████████  100%
    Structure      █████████████░░  90%

Cross-Project Intelligence

Atlas finds patterns across your repos that no single-repo tool can see:

╭───────────────── Cross-Project Intelligence ──────────────────╮
│                                                                │
│  Shared Dependencies                                           │
│    ℹ  fastapi used across 4 projects                           │
│    ℹ  react used across 3 projects                             │
│                                                                │
│  Version Mismatches                                            │
│    ⚠  react: ^18.2.0 (app-a), ^19.2.1 (app-b)                 │
│    ⚠  fastapi: >=0.100.0 (api-v1), >=0.115.9 (api-v2)         │
│                                                                │
│  Health Gaps                                                   │
│    ✖  3 projects have zero tests                               │
│    ⚠  1 project has 50+ uncommitted changes                    │
│                                                                │
╰────────────────────────────────────────────────────────────────╯

Commands

Requirements

• Python 3.11+
• git (for repo detection)

How It Works

Atlas scans your project directories — no network calls, no cloud, no telemetry. Everything runs locally.

1. File walking — counts source and test files, skipping node_modules, .venv, target, etc.
2. Config parsing — reads pyproject.toml, package.json, Cargo.toml for deps and frameworks
3. Git inspection — runs git log, git status, git branch for repo health
4. Health scoring — weighted formula across 4 dimensions → A-F grade
5. Cross-project analysis — compares deps, versions, and patterns across all repos

State lives in ~/.atlas/portfolio.json. Portable, inspectable, no database.

FAQ

Is this open source? Yes. MIT license. Every feature is free. No tiers, no gates, no "upgrade to unlock."

Does it phone home? No. Zero network calls. No telemetry. No analytics. Your code stays on your machine.

How fast is it? 8 projects with 1.25M lines of code scanned in 31 seconds.

Does it work with monorepos? Each atlas add path is treated as one project. For monorepos, add the root.

Can I use it in CI? Yes. The published GitHub Action installs Atlas, runs the health check, and posts a sticky portfolio-health comment on every PR — one line in your workflow:

# GitHub Actions
- uses: nxtg-ai/atlas-action@v1
  with:
    min-health: '70'
    min-project-health: '50'

(This repo dogfoods its own action — PRs get a 🟢 B+ health comment.) Prefer to run the CLI directly? atlas ci outputs JSON and exits non-zero on health violations:

- run: atlas ci --min-health 70 --min-project-health 50

Support This Project

Atlas is free and always will be. If it saves you time, consider supporting development:

Support Atlas →

Supporters get their name in SUPPORTERS.md, priority GitHub issues, and early access to new features.

License

MIT

Built by NXTG.AI — the team behind NXTG-Forge.