Metadata-Version: 2.4
Name: termagent-cli
Version: 0.5.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: ollama
Requires-Dist: textual
Requires-Dist: rich

# Termagent: Natural Language PowerShell Agent

Termagent is a powerful, Windows-native AI agent that transforms natural language instructions into executable PowerShell commands. Built for both non-technical users and power developers, it bridges the gap between intent and execution through a sophisticated agentic workflow.

## 🚀 Key Features

- **Natural Language Translation**: Convert plain English into complex PowerShell scripts instantly.
- **Stateful Orchestration**: Built on **LangGraph**, allowing the agent to remember context, navigate directories, and handle multi-step operations.
- **Session Memory**: Retains conversation history within the session, enabling highly contextual interactions and follow-up adjustments.
- **Clean Agent Graph**: Utilizes a streamlined, robust graph architecture for efficient intent routing.
- **Dual-Layer Safety Architecture**:
    - **Static Blacklist**: Prevents system-critical operations (e.g., System32 access, Registry edits) before they reach the LLM.
    - **LLM Security Review**: A second layer of reasoning that flags context-specific risks.
- **Human-in-the-Loop (HITL)**: Risky commands are never executed without explicit user confirmation.
- **Textual TUI**: A beautiful, responsive terminal user interface for a premium CLI experience.
- **Email Integration**: Compose and send professional emails with attachments directly from the terminal.

## 🛠️ Architecture

Termagent utilizes a Directed Acyclic Graph (DAG) state machine to manage the conversation flow, tool selection, and command validation. By running inference on **Groq**, it ensures near-instant response times while maintaining high reasoning quality.

## 🚀 Quick Start

Get started in under 3 minutes!

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

## ⚠️ Safety First

While Termagent is designed to be helpful, it executes real commands on your system. Always review flagged commands before confirming execution.
