Termagent: Natural Language Terminal Agent for Windows

Termagent is a powerful, Windows-native AI agent that transforms natural language into executable PowerShell commands, professional emails, research documents, web searches, and full GitHub workflows — all from a single terminal interface. Built on LangGraph with Groq inference, it combines near-instant response times with intelligent intent routing, dual-layer safety, and a stunning Textual TUI.

🚀 Key Features

• Natural Language → PowerShell: Convert plain English into complex PowerShell scripts instantly.
• Smart Intent Routing: Five-way LLM classifier automatically routes to the right pipeline — command, chat, email, document, or GitHub.
• Session Memory: Retains last few messages as history within a session for contextual follow-ups.
• Web Search (ReAct): Answers questions with real-time information via DuckDuckGo search, synthesized through a ReAct tool-use loop.
• Document Creation: Generates well-formatted .docx reports with headings, tables, bullet points, and inline formatting — powered by web research and LLM knowledge.
• Email Integration: Compose and send professional emails with attachments via Gmail SMTP. Structured output handles recipient, subject, body, and multi-file attachments.
• GitHub & Git (MCP-Powered): Full git and GitHub operations via the Model Context Protocol — commit, push, create releases, list PRs, manage issues, and more. Combines local git tools with dynamically-discovered GitHub MCP tools in a ReAct loop.
• Coding Tasks: Capable of handling coding tasks. Plans and executes various tasks, HITL for safety.
• File Reading: Read .docx, .pdf, .txt, and .md files for use in chat or document workflows.
• Dual-Layer Safety: Static blacklist blocks dangerous patterns instantly; LLM security review catches context-sensitive risks.
• Human-in-the-Loop (HITL): Risky commands always require explicit user confirmation before execution.
• Raw PowerShell Mode: Prefix with ! to bypass the agent and run PowerShell directly.
• Textual TUI: Dark-themed terminal UI with animated spinner, rich markdown rendering, and status indicators.

🛠️ Architecture

Termagent uses a LangGraph state machine with pre-check short-circuiting, five-way intent classification, and multiple ReAct loops for tool-augmented nodes. Inference runs on Groq (llama-3.3-70b for classification, gpt-oss-120b for reasoning) for near-instant responses.

🚀 Quick Start

pip install termagent-cli
termagent

⚠️ Safety First

Termagent executes real commands on your system. Always review flagged commands before confirming.