← Discover MCPs and Agents
t
MCPAI & MLGitHub

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" to mkdir folder
  • Dark Futuristic GUI
    Responsive interface built with Rust's eframe featuring 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.