CHAOOS

Aethel / Google Drive CLI

Drive sync,
on your terms.

Aethel gives Google Drive a Git-style workflow: inspect changes, choose what moves, and keep a history of every successful sync.

See the workflow ↓ View on npm ↗
LOCAL./workspace
DRIVEGoogle Drive
SNAPSHOT7ac91f2

COMPARE THREE STATES
BEFORE YOU CHANGE FILES

01 / WHAT IT DOES

No more blind mirroring.

01

See every difference

Compare your local folder, Drive, and the last saved snapshot before a file moves.

02

Stage a deliberate sync

Review suggested actions with status and diff, then commit only what you intend.

03

Resolve conflicts explicitly

When both copies change, choose the local version, the Drive version, or keep both.

04

Work your way

Use concise CLI commands or open a dual-pane terminal UI for hands-on file management.

02 / TRY THE FLOW

Sync with a clear baseline.

aethel / workspaceillustrative demo

Nothing runs here. This is the normal Aethel decision flow.

Step 1 of 4 — inspect


        

          
          
          
        

      

    


    

      

        
03 / FIRST TEN MINUTES

        
From zero to your first sync.

      

      
    
        
  1. 01
    Install Aethel
    Node.js 22.12 or newer is required.
    npm install -g aethel
    2. 
        
  2. 02
    Connect Google Drive
    Create a Desktop OAuth client in Google Cloud, enable the Google Drive API, then save the downloaded file here:
    ~/.config/aethel/credentials.json
    Keep credentials.json and token.json local. Never commit them.
    aethel auth
    3. 
        
  3. 03
    Start a workspace
    Clone a Drive folder, then pull its current contents to establish your first local copy.
    aethel clone <folder-id-or-url> ./workspace
    cd ./workspace && aethel pull --all -m "initial pull"
    4. 
      

    


    

      

        
04 / KEEP EXPLORING

        
The commands you’ll reach for.

      

      

        
aethel status
See local, remote, staged, and conflicted changes.

        
aethel pull -m "pull"
Apply Drive changes since your last snapshot.

        
aethel push --dry-run
Preview local changes before uploading to Drive.

        
aethel tui
Open the interactive dual-pane file browser.

      

      

        
Ready to make Google Drive feel deliberate?

        Explore Aethel on GitHub ↗