initiate

README.md

@@ -0,0 +1,102 @@
+# Gmail Inbox Analyzer
+
+A Go script to fetch sender and subject information from your Gmail inbox for organization purposes.
+
+## Setup
+
+1. Go to [Google Cloud Console](https://console.cloud.google.com/)
+2. Create a new project or select an existing one
+3. Enable the Gmail API
+4. Go to "Credentials" → "Create Credentials" → "OAuth 2.0 Client IDs"
+5. Choose "Desktop application"
+6. Note down your Client ID and Client Secret
+
+## Usage
+
+```bash
+go mod tidy
+go run main.go <CLIENT_ID> <CLIENT_SECRET> <csv|json>
+```
+
+### Authentication Flow
+
+1. The script will display a URL
+2. Visit the URL in your browser and log into your Google account
+3. Copy the authorization code from the browser
+4. Paste it back into the terminal
+
+### Output Formats
+
+- **CSV**: `go run main.go CLIENT_ID CLIENT_SECRET csv > emails.csv`
+- **JSON**: `go run main.go CLIENT_ID CLIENT_SECRET json > emails.json`
+
+### Example
+
+```bash
+go run main.go "123456789-abc.apps.googleusercontent.com" "GOCSPX-your_secret" csv > my_emails.csv
+```
+
+The script fetches all emails from your inbox with:
+- Sender email address
+- Subject line
+- Date
+- Message ID
+
+No credentials are stored locally - authentication is required each time you run the script.
+
+## Organization Tools
+
+After exporting your email data, use these additional tools to organize your inbox:
+
+### 1. Email Analysis
+Analyze patterns in your exported data:
+```bash
+go run analyze.go emails.csv summary
+go run analyze.go emails.csv json > analysis.json
+```
+
+### 2. Gmail Filter Generator
+Generate Gmail filters based on your email patterns:
+```bash
+go run filters.go analysis.json filters    # Show filter suggestions
+go run filters.go analysis.json queries    # Show search queries
+go run filters.go analysis.json all        # Show everything
+```
+
+### 3. Cleanup Recommendations
+Get specific cleanup recommendations:
+```bash
+go run cleanup.go analysis.json summary    # Quick overview
+go run cleanup.go analysis.json detailed   # Full instructions
+```
+
+### 4. Interactive Organization Wizard
+Run the complete organization workflow:
+```bash
+go run organize.go emails.csv
+```
+
+This will guide you through:
+- Email analysis
+- Organization approach selection (aggressive cleanup, filters-focused, balanced, or analysis-only)
+- Step-by-step implementation
+
+## Workflow Example
+
+```bash
+# 1. Export your Gmail data
+go run main.go "your-client-id" "your-secret" csv > emails.csv
+
+# 2. Run the organization wizard
+go run organize.go emails.csv
+
+# 3. Follow the interactive prompts to organize your inbox
+```
+
+The tools will help you:
+- Identify top senders and domains
+- Detect email patterns (newsletters, promotions, etc.)
+- Generate Gmail filters for automatic organization
+- Find emails safe to delete or archive
+- Create unsubscribe recommendations
+- Provide specific Gmail search queries for cleanup