TFM (The Future Manager) is a next-generation file management solution that bridges the gap between classic terminal efficiency and modern AI automation. Whether you need a robust dual-pane file browser or an intelligent assistant to organize your digital life, TFM has you covered.
- Dual-Pane Interface: Classic Commander-style layout for efficient file operations.
- Keyboard-First Navigation: Fast, intuitive shortcuts for power users.
- Async Operations: Non-blocking file deletions and background tasks keep the UI responsive.
- Rich Visuals: Built with Textual for a beautiful terminal experience.
- Natural Language Commands: "Organize my downloads by date" or "Find duplicates in Photos".
- Smart Execution: The built-in AI engine (powered by Gemini integration) interprets your intent and executes complex batch operations.
- Quick Actions: One-click buttons for common tasks like cleanup, organization, and renaming.
- Scriptable Power: Automate your workflows directly from the shell.
- Batch Processing: Organize, clean, search, and rename thousands of files in seconds.
- Dry Run Support: Preview changes before they happen.
-
Clone the repository:
git clone https://github.com/DaRipper91/automatic-tribble.git cd automatic-tribble -
Install dependencies:
pip install -r requirements.txt
-
Optional (for CLI command access):
pip install -e .
Start the interactive file manager:
python run.pyNavigate with arrow keys, use Tab to switch panels, and press ? or h for help.
Organize your Downloads folder by file type immediately:
python src/file_manager/cli.py organize --source ~/Downloads --target ~/Documents/Sorted --by-type(Or use tfm-auto if you installed with pip install -e .)
For a deep dive into all features, keyboard shortcuts, and advanced configuration, please consult the User Manual.
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.