Terminal AI Assistant

A powerful CLI tool that helps users interact with the macOS Terminal using natural language. Built with Node.js and powered by DeepSeek-V3 AI.

Features

• 🤖 Natural language to command conversion
• 💻 Real-time command execution
• 🛡️ Secure command handling
• ⚡ Fast response times
• 🔒 Built-in API key encryption
• 🖥️ Cross-platform support

Installation

npm install -g terminal-ai-assistant-mac

Usage

After installation, you can use the tai command followed by your natural language query:

taim "create a new folder called projects"
taim "list all files in current directory"
taim "find all pdf files in downloads folder"

Examples

File operations:

taim "create a backup of important.txt"
taim "delete all temporary files"
taim "move all images to pictures folder"

System information:

taim "show system information"
taim "list running processes"
taim "check disk space"

Network commands:

taim "show my ip address"
taim "test internet connection"

Project Structure

terminal-ai-assistant/
├── src/ # Source files
│ ├── services/ # Service layer
│ │ ├── aiService.ts # AI command generation
│ │ └── commandService.ts # Command execution
│ ├── types/ # TypeScript types
│ └── cli.ts # CLI entry point
├── tsconfig.json # TypeScript configuration
└── package.json # Project configuration

Technology Stack

• 🟦 TypeScript - Type safety and modern JavaScript features
• 🤖 DeepSeek-V3 - Advanced AI model for command generation
• 🔐 Node.js crypto - Secure API key handling
• 🎨 Chalk - Beautiful terminal output
• 📝 Commander.js - CLI framework

Security Features

• Encrypted API key storage
• Admin command detection
• Secure command execution
• Input sanitization

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Rushikesh Nimkar

Acknowledgments

• DeepSeek AI
• Node.js
• Commander.js