Kora - AI File Manager & Organizer

🤖 An intelligent CLI tool that helps you manage and organize your files using natural language commands powered by Google Gemini AI.

Features

• Natural Language Interface: Just tell Kora what you want to do with your files
• Smart File Organization: Automatically organize files by type, date, or custom criteria
• Interactive Chat: Conversational interface like Claude or Gemini CLI
• Tool Chaining: Performs multiple operations in sequence to complete complex tasks
• Safe Operations: Confirms actions before executing destructive operations

Installation

npm install -g kora-ai

Usage

Simply run kora in your terminal to start the interactive session:

kora

Example Conversations

🤖 Welcome Agent! I'm ready to help you manage your files.

You: Can you please organize all my files?
Kora: Sure! I'll organize your files by type. Let me scan the current directory first...

[Organizing files...]
✅ Done! I've organized 25 files into 6 categories (Images, Documents, Videos, etc.)

You: Move all PDF files to a Documents folder
Kora: I'll create a Documents folder and move all PDF files there.

[Creating folder and moving files...]
✅ Moved 8 PDF files to the Documents folder.

You: Find all files larger than 100MB
Kora: Searching for large files...

Found 3 files larger than 100MB:
- video.mp4 (250MB)
- backup.zip (180MB)
- presentation.pptx (120MB)

Available Commands

Kora understands natural language, so you can phrase your requests however feels natural:

• File Organization: "organize my files", "sort files by type", "clean up this folder"
• File Operations: "move all images to Pictures", "copy documents to backup folder"
• Search: "find all PDF files", "show me large files", "locate files modified today"
• Cleanup: "delete temporary files", "remove duplicates", "clean up downloads"
• Directory Management: "create a new folder called Projects", "organize by date"

Setup

On first run, Kora will ask for your Google Gemini API key. Get one from: https://makersuite.google.com/app/apikey

Your API key is stored securely in ~/.kora-config.json

Requirements

• Node.js 14 or higher
• Google Gemini API key

Commands

• help - Show available commands and examples
• exit or quit - Exit Kora

License

MIT License - see LICENSE file for details.