termagent-cli 0.5.0

Natural language terminal agent for Windows PowerShell

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!

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.