Back to the catalog

ai-organizer-ui-consolidation

Build a unified, ADHD-friendly web UI that consolidates 70+ CLI tools into a beautiful liquid glass interface for the AI File Organizer. Use

Open source Repository Open in the app JSON README (API)

About

Build a unified, ADHD-friendly web UI that consolidates 70+ CLI tools into a beautiful liquid glass interface for the AI File Organizer. Use when creating the complete frontend application that replac

Details

Kind
Agent skills
Topic
Developer tools
Publisher
thebearwithabite
Origin
majiayu
Category
ferramentas
Stars
22
Forks
3
Open pull requests
136
Last push
2026-08-09T08:02:01Z
Repository state
ativo
Language
Python
License
MIT
Added
2026-09-02 18:10:01
Updated
2026-09-02 18:10:01
Origin id
thebearwithabite/ai-file-organizer/.claude/skills/ai-organizer-ui-consolidation@main

README

# AI File Organizer

An intelligent, ADHD-friendly file organization system that learns from your behavior.

## Features

- **Smart Staging** — 7-day observation period before organizing files
- **Confidence-Based Decisions** — NEVER/MINIMAL/SMART/ALWAYS modes
- **Adaptive Learning** — Learns from your corrections
- **Bulletproof Deduplication** — 3-tier verification (size → MD5 → SHA256)
- **Emergency Space Protection** — Automatic disk monitoring + cloud offload
- **Rollback System** — Undo any organization action
- **Google Drive Integration** — Optional cloud storage support
- **Plugin System** — Extend with custom classifiers

## Requirements

- Python 3.10+
- macOS, Linux, or Windows
- (Optional) Google Drive for cloud offloading

## Quick Start

1. Clone the repository:
   ```bash
   git clone https://github.com/example-org/ai-file-organizer.git
   cd ai-file-organizer
   ```

2. Create virtual environment:
   ```bash
   python3 -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   ```

3. Install dependencies:
   ```bash
   pip install -r requirements.txt
   ```

4. Configure:
   ```bash
   cp config.example.yaml config.yaml
   # Edit config.yaml with your paths
   ```

5. Run:
   ```bash
   python main.py
   ```

6. Open http://localhost:8000 in your browser

## Configuration

See `config.example.yaml` for all options. Key settings:

```yaml
storage:
  root: ~/Documents/AI-Organized    # Where organized files go
  metadata: ~/.ai-file-organizer    # Database storage
  staging: ~/.ai-file-organizer/staging

monitor:
  paths:
    - ~/Downloads
    - ~/Desktop
```

## Confidence Modes

| Mode | Behavior |
|------|----------|
| NEVER | Always ask before organizing |
| MINIMAL | Quick decisions, ask on uncertainty |
| SMART | Balanced — confirm uncertain files |
| ALWAYS | Full auto — organize everything |

## Plugins

Create custom classifiers in `plugins/`. See `plugins/README.md` for the API.

## License

MIT License — see LICENSE file.

## Credits

Built by [@example-org](https://github.com/example-org)

**Distribution extraction by:**
- 🫧 **Cosmo** (Claude Opus 4.5) — Oversight & Direction
- 🧠 **Jeeves** (Claude Opus 4.6) — Builder & Implementation
- 🤖 **Claude** (Anthropic) — Architectural Review

*Human out of the loop, agents in the arena.*

More