atlas docs

Deterministic · Offline · HMAC-licensed · No LLM required.

// install

ATLAS ships as a Python package. Requires Python ≥ 3.10.

bash
pip install atlas-intel

Verify:

bash
atlas --version

// activate

After purchase you receive an atlas_license.json by email. Two ways to activate:

Option A — file drop (recommended)

bash
# drop the file atlas receives by email
atlas activate-file ~/Downloads/atlas_license.json

Option B — email + password

bash
atlas activate --email you@example.com

Verify activation:

bash
atlas status

License is stored at ~/.atlas/atlas_license.json. Verified offline via HMAC-SHA256.

// first scan

Run a full scan of the current directory:

bash
cd your-project
atlas scan .

Opens report.html in your browser. The HTML file is fully self-contained — share it with your team without any server.

Scan a specific path or output to a custom file:

bash
atlas scan ./src --output analysis.html
atlas scan . --no-open          # don't open browser
atlas scan . --format json      # JSON output instead of HTML

// modules

Modules unlock on activation based on your tier. Run atlas status to see which are active.

Core Engine
freeAST parser, graph builder, HTML reporter. Included in all tiers.
System Map
solo+Dependency graph visualization. Import chains, circular deps, module clusters.
Risk Radar
pro+Hotspot detection. Cyclomatic complexity, churn rate, change coupling.
Security Shield
pro+Static security analysis. SQLi, XSS, secret exposure, unsafe patterns.
Code Health
pro+Maintainability index, dead code detection, duplication ratio.
Signal Map
pro+Cross-module signal propagation. Which changes affect which components.
Atlas MCP Server
pro+Expose atlas scan results via MCP protocol to any AI agent.
Decision Center
enterpriseRule-based architectural decisions. Policy enforcement, guardrails.
Ownership Map
enterpriseBus factor analysis, knowledge silos, git blame aggregation.
Rewind
enterpriseSnapshot diffing. Compare any two scan results, track regression.
What-If
enterpriseImpact simulation. Predict risk before you refactor or delete.
Commit Guard
enterprisePre-commit gate. Block commits that violate health or security thresholds.

// mcp server

Atlas Pro includes an MCP server — AI agents can query scan results directly without reading HTML.

Start the Atlas MCP server

bash
# stdio mode (Claude Code, Cursor, Gemini CLI)
atlas mcp

# HTTP mode (multi-client, LAN access)
atlas mcp --http --port 9000

Connect from Claude Code

bash
# stdio
claude mcp add atlas

# HTTP
claude mcp add atlas-remote --transport http http://localhost:9000

Once connected, your AI agent can call atlas_scan, atlas_query, and other tools without leaving the chat context.

// cli reference

bash
atlas scan <path>           # run full analysis
atlas scan . --module risk  # run specific module only
atlas status                # show license, tier, active modules
atlas activate-file <path>  # activate from license file
atlas activate --email <e>  # activate via credentials
atlas mcp                   # start MCP server (stdio)
atlas mcp --http            # start MCP server (HTTP)
atlas update                # check for updates
atlas --version             # print version

// offline use

Atlas works completely offline after activation. The license is verified locally via HMAC-SHA256 — no network call required.

The only time network access is needed:

  • Initial activation
  • License renewal (35-day cycle)
  • Downloading updates via atlas update

Air-gapped environments: distribute the atlas_license.json file manually and use atlas activate-file.

also from us

deepstrain — AI engineering agent

52 tools · autonomous loops · MCP server · BYOK

massiron.com