Metadata-Version: 2.4
Name: termagent-cli
Version: 1.1.0
Summary: Natural language terminal agent for Windows PowerShell
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: langchain-groq
Requires-Dist: langchain-core
Requires-Dist: langchain
Requires-Dist: langgraph
Requires-Dist: pydantic
Requires-Dist: python-dotenv
Requires-Dist: textual
Requires-Dist: rich
Requires-Dist: ddgs
Requires-Dist: mcp
Requires-Dist: sounddevice
Requires-Dist: scipy
Requires-Dist: numpy
Requires-Dist: groq
Requires-Dist: python-docx
Requires-Dist: pdfplumber
Requires-Dist: requests

# 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

```bash
pip install termagent-cli
termagent
```

## ⚠️ Safety First

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