terminalAI
TerminalAI is an AI-driven terminal assistant
Links
README
From the repo.
TerminalAI: AI-Powered Terminal Assistant
TerminalAI is an AI-driven terminal assistant that combines a sleek, dark-themed interface with natural language processing to transform plain English instructions into executable bash commands. Built with Rust for performance and Python for AI integration, it offers a modern workflow enhancement for developers.
✨ Features
- Natural Language Processing
Convert phrases like "create a folder" tomkdir folder - Dark Futuristic GUI
Responsive interface built with Rust'seframefeaturing real-time typing - Smart Autocomplete
Tab-complete files/directories with Tab - Direct Command Execution
Run native bash commands (pwd,ls --color,clear,cd) - GPT-4 Integration
Powered by Dockerized FreeGPT4-WEB-API - Robust Error Handling
Clear diagnostics for API issues and invalid commands
🚀 Getting Started
Prerequisites
-
Rust:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -
Python 3.13+::
sudo apt-get install python3 python3-pip python3-venv -
Install Docker
Installation
-
Clome repo:
git clone https://github.com/nitindahiya-dev/terminalAI.git cd terminalAI -
Set Up Python Environment:
python3 -m venv venv source venv/bin/activate pip install requests -
Launch GPT-4 API:
docker run -p 5500:5500 d0ckmg/free-gpt4-web-api -
Build Rust Project:
cargo build -
Launching the Application:
# Ensure Docker API is running in background source venv/bin/activate cargo run -- --interactive
📚 Examples
-
Create Directory:
user@host $ create a logs folder → Executed: mkdir logs_folder -
List Files with Colors:
user@host $ list files in detail → Executed: ls --color -l -
System Command:
user@host $ clear → Terminal cleared
🔧 Troubleshooting
-
Verify AI agent path::
/projects/terminalAI/venv/bin/python3 ai_agent.py "create folder"Expected output: {"command":"mkdir folder"}
-
❌ API Connection Issues:
docker ps netstat -tuln | grep 5500 -
🔄 UI Rendering Problems:
desired_width = 600.0, window_size = (800.0, 600.0)
Collected info
- ★ 6 stars
- Language: Rust
- Source updated: 4/17/2026
Config for your environment
Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.
Tool
OS
Config file: ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "{MCP_ENDPOINT_URL}"
}
}
}Paste into mcpServers in the config file. Restart Cursor after saving.
If this MCP is also published on mcpchannel.ai, you can subscribe from Browse and use the gateway config there instead.