An AI-powered local filesystem assistant. Instead of manual sorting and naming, simply describe your intent and let aifiler handle the planning, approval, and execution.
- 🧠 Dynamic Planning: Translates natural language into structured filesystem operations.
- 🗂️ Context Awareness: Intelligently scans your workspace to provide relevant suggestions.
- ✅ Safety First: Every action is staged for your approval before execution.
- 🔌 Provider Agnostic: Supports OpenAI, Anthropic, Gemini, Ollama, and Vercel AI Gateway.
- 🎨 Modern CLI: Clean, professional output with interactive arrow-key menus and colorful progress feedback.
- ⏪ One-Click Undo: Accidentally applied a plan? Revert changes instantly with the
undocommand. - 💬 Clean Output: Optimized for fast, readable, plain-text AI interactions without markdown clutter.
Run aifiler followed by your request in quotes. By default, it scans only the root directory for context.
aifiler "organize my images into folders by year"Download the latest binary from releases or install via a package manager.
scoop bucket add aifiler https://github.com/JoshiMinh/aifiler
scoop install aifilerrun.batgo mod tidy
go build -o aifiler ./cmd/aifiler
./aifileraifiler stores its configuration in config.yaml. You can set your API keys directly in the file or use the command line:
aifiler set <provider> <api_key>| Provider | Key | Default Model | Notes |
|---|---|---|---|
| OpenAI | openai |
gpt-4o |
High quality planning |
| Anthropic | anthropic |
claude-3-5-sonnet |
Excellent reasoning |
| Google Gemini | gemini |
gemini-1.5-flash |
Fast and long context |
| Ollama | ollama |
llama3 |
Run 100% locally |
| Vercel AI Gateway | vercel |
gemini-2.5-flash |
Recommended for speed |
Contributions are welcome! If you find a bug or have a feature request, please open an issue or submit a Pull Request.
This project is licensed under the MIT License. See the LICENSE file for the full text.
Built with ❤️ by [JoshiMinh](https://github.com/JoshiMinh)
