HolleyStudios
TITAN OF DRIVE ORGANIZATION

The Weight of Data,
Finally Lifted.

The only file organizer that requires your approval before moving anything.

Preview every move. Approve before it happens. Undo anything, instantly. Atlas uses AI confidence scoring to organize your files — and never touches a single one without your explicit sign-off.

Get Started FreeDownload Desktop App
bash
$ npm install -g atlas-drive-agent$ atlas init$ atlas scan$ atlas classify --ai$ atlas dry-run$ atlas review && atlas execute
Metadata only — never reads file contents139 tests passingFull rollback from audit logZero cost to startOpen source

The Problem

You know what an unorganized Drive costs you.

The search tax.Every day you can't find something, you pay in lost time and broken focus. With thousands of files and no consistent structure, it only compounds.

The naming chaos. “Invoice Final FINAL v3 (1).pdf” means three different things in three different contexts. Multiply that by 10,000 files and no one can trust what they're looking at.

The fear of touching it. Reorganizing manually means one wrong move orphans a Google Form from its response data, or moves a file someone else owns, or breaks a shared link. So nothing gets cleaned up. Ever.

“Atlas was built for this exact situation — Drive at scale, with history, with shared files, with stuff you're afraid to touch. It proposes every change. You approve the plan. Nothing runs without you.”

— Matthew Holley, Founder · Holley Studio

Built For

If you use Google Drive for real work, Atlas is for you.

Freelancers & Consultants

Years of client projects, invoices, contracts, and briefs — all in one Drive with no structure. Atlas classifies by file type and context, proposes the right folders, and shows you the plan before touching a single file.

Creative Agencies

Thousands of assets across clients and campaigns. Inconsistent naming from a revolving door of contractors. Atlas standardizes names and structure across your entire Drive in one organized run.

Legal & Finance Teams

Compliance requires knowing what moved, when, by whom, and what it looked like before. Atlas writes an append-only JSONL audit log for every action — GDPR and SOC 2 ready out of the box.

Startups on Google Workspace

Drive starts clean. Then the team grows, clients get added, and three years later nobody knows where anything is. Atlas brings structure back without breaking shared links or moving files you don't own.

The Pipeline

Understand. Plan. Organize.

Every step is explicit. You control when Atlas acts and what it does. Only two commands ever write to Drive.

01

Understand your Drive

atlas scan

Reads Drive metadata. Never file contents. Outputs full inventory.

atlas classify

Confidence scoring across 5 signals: MIME type, extension, keywords, folder context, date patterns.

atlas health

Drive Health Score across 6 dimensions: organization, duplicates, staleness, version sprawl, sharing risk, coverage.

02

Plan the change

atlas plan

Generates move plan. Auto-approves high-confidence files (≥0.90). Flags others for review.

atlas validate

Checks for blocked files — Forms, non-owned — and surfaces warnings before you commit.

atlas dry-run

Full preview. Shows exactly what would move, rename, or be trashed. Zero Drive writes.

atlas review

TUI approval flow or Google Sheets export for team sign-off.

03

Organize and stay organized

atlas execute

Moves and renames approved files. Audit log written before each operation.

atlas rollback-plan

Generate reverse plan from audit log. Undo everything with one command sequence.

atlas watch

Real-time monitoring. New files classified and proposed for organization as they land.

Only atlas execute and atlas trash write to Drive. Every other command is read-only.

What Atlas Does

Everything manual organization can't.

Organize at Scale

  • Move thousands of files into the right folders automatically
  • Auto-create folder structure — no manual setup required
  • Mass rename with configurable naming conventions
  • Detect and stage duplicates for Trash review
  • Export plan to Google Sheets for team approval

Always Safe to Run

  • Dry-run preview before any Drive write
  • Crash-safe audit log — recovery always possible
  • One-command rollback from the audit log
  • Owner-only by default — shared files blocked unless you opt in
  • Google Forms permanently blocked — no data orphaning, ever

Know Your Drive

  • Drive Health Score across 6 dimensions
  • Stale sharing detection — who has access who shouldn't
  • Version sprawl scoring — find the _v3_FINAL_FINAL files
  • GDPR & SOC 2 ready audit trails
  • Natural language search via Claude AI (atlas query)

The Safety Model

Atlas never permanently deletes a single file. Not one.

Six rules are hardcoded into Atlas. They cannot be overridden by config flags, environment variables, or command-line arguments.

01

Rate Limiting

Every Drive API call is wrapped in a rate limiter (5 concurrent, exponential backoff). Quota errors are structurally impossible.

02

Crash-Safe Audit Log

Audit entry written as 'pending' before each move or rename. Updated to 'success' or 'failed' after. If Atlas crashes mid-execute, the log still records exactly what happened.

03

Owner Guard

Files you don't own are blocked by default. Pass --allow-shared to override explicitly — it's never the default behavior.

04

Keychain Tokens

OAuth tokens stored in macOS Keychain via keytar. Never written to a plain file on disk. Industry-standard secret management.

05

Forms Always Blocked

Moving a Google Form permanently severs its link to the response Spreadsheet — data loss with no recovery. Atlas blocks this unconditionally. No flag overrides it.

06

Provider Isolation

All Drive API calls isolated in a dedicated provider layer. Business logic never calls Google directly, enabling full unit testing without real API calls.

What Atlas Never Does

Read or download file contents
Permanently delete files (Trash only — 30-day recovery window)
Touch Gmail, Calendar, Contacts, or any non-Drive Google service
Move or rename without an audit entry written first
Auto-execute without your approval at dry-run or review stage
Move Google Forms

New Files, Instantly Organized

Don't just clean your Drive once.
Keep it clean.

atlas watch subscribes to your Drive's push webhook. Every file that lands in your Drive is immediately scanned, classified, and added to your pending plan. High-confidence files (≥0.90) are flagged for immediate approval. Your Drive stays organized without you doing anything.

  • Real-time push webhook from Google Drive
  • Classifies new files as they land
  • High-confidence files auto-staged for approval
  • Works with any public HTTPS endpoint

Watch mode requires a public HTTPS endpoint for Google's push webhook. Use ngrok in development; any cloud URL in production.

Live · atlas watch

Invoice_March_2024.pdf

→ Finances/Invoices

0.94✓ auto14:23:01

Brand_Guidelines_v2.pdf

→ Clients/Acme/Brand

0.87⊙ review14:23:44

Meeting Notes - Q2.docx

→ Projects/Internal

0.91✓ auto14:31:12

Classified. Every file. Every time.

Mass Rename

One naming convention. Every file.

Atlas doesn't just move files into the right folders — it standardizes names across thousands of files in the same pipeline. Configure your convention once. Atlas proposes every rename. You approve before it runs.

atlas.config.json

json
{
  "namingConvention": {
    "enabled": true,
    "replaceSeparator": "_",
    "removeSpecialChars": true,
    "caseStyle": "lower",
    "stripVersionSuffix": true,
    "datePrefix": true
  }
}

atlas dry-run — rename preview

Invoice (Final Copy).pdf2024-03-15_invoice_final_copy.pdf
Budget v3 - FINAL.xlsx2024-01-01_budget.xlsx
MY REPORT.PDF2024-06-01_my_report.pdf
Brand Guidelines v2.pdf2024-02-10_brand_guidelines.pdf

Rename runs in the same pipeline as move — previewed in dry-run, audited in the log, fully reversible.

Pricing

It's free. Seriously.

Google Drive API

Free

1,000 requests / 100 sec included. Atlas never exceeds this quota through its rate limiter. Charges only apply at enterprise scale.

Atlas CLI

Free

Open source. No subscription, no SaaS backend, no per-run fees. You own the tool.

Claude AI

Optional

~$0.0003 per atlas query. Only charged when you pass --ai. Zero tokens used by default — AI features are fully opt-in.

A complete Drive organization run uses zero Claude tokens by default.

Scan, classify, plan, review, execute. All of it. No API key required, no AI charges. AI features unlock when you're ready for them.

Atlas Desktop

No terminal required. Download and organize.

The same AI-powered organization engine — now as a native desktop app for Mac, Windows, and Linux. Scan any local folder, get a health grade (A+ to F), review every suggested move, then organize with one click. No Google account needed. 4 MB. No Electron.

macOS

.dmg · Apple Silicon + Intel

Universal binary

Download

Windows

.msi · Windows 10/11

64-bit installer

Download

Linux

.AppImage + .deb

Ubuntu · Debian · others

Download
Free & open source4 MB — no Electron, no ChromeNo account · No cloud · No telemetryUndo every move, instantlyAI confidence scoring, local — no cloud AI

Atlas CLI — For Developers

Organized Drive in 10 minutes.

Full Google Drive integration. AI classification. Audit logs. Team approvals. Everything via the terminal.

bash
# 1. Install$ npm install -g atlas-drive-agent # 2. First-time setup (guided wizard — 5 min)$ atlas init # 3. Scan your Drive (read-only, no writes)$ atlas scan # 4. Classify and generate move plan$ atlas classify # 5. Preview everything before touching Drive$ atlas dry-run # 6. Approve and execute$ atlas review$ atlas execute

Prerequisites

Node.js 20 LTSnvm install 20 && nvm use 20
Google Cloud credentialsDrive API enabled + credentials.json — 10-min setup in the full guide
ANTHROPIC_API_KEY (optional)Only for atlas query natural language search

Ready to Organize

Stop managing Drive manually.

Atlas does the hard work. You approve the plan.

Install Atlas FreeRead the Full Guide

Open source. Free to use. No account required.

“Every move is logged. Every rename is logged. And if something goes wrong — roll back with three commands.”

— Atlas safety guarantee