⚡ TermiAgent (tui-code)

Terminal-native AI coding agents (like Claude Code and Aider) represent the most productive developer workflow shift in years. TermiAgent is a high-speed open-source terminal engineer equipped with an interactive TUI console, unified line-by-line diff visualizer, auto-commit generator, and multi-model support.

  _____                   _   ___                    _    
 |_   _|__ _ __ _ __ ___ (_) / _ \ __ _  ___ _ __  | |_  
   | |/ _ \ '__| '_ ` _ \| |/ /_\// _` |/ _ \ '_ \ | __| 
   | |  __/ |  | | | | | | |  _  | (_| |  __/ | | || |_  
   |_|\___|_|  |_| |_| |_|_|_| \_\__, |\___|_| |_(_)__| 
                                 |___/                   

• ⚡ Keyboard-First Terminal TUI Workspace: Terminal console displaying step-by-step reasoning steps, file reads, diff outputs, and test execution logs.
• 📄 Unified & Side-by-Side Diff Inspector: Inspect additions and deletions line-by-line before applying patches to disk.
• 🦙 100% Local Execution: Built to run seamlessly on local Ollama endpoints (Qwen 2.5 Coder, DeepSeek V3, Llama 3) for zero token costs.
• 🌿 Git Workspace Integration: Scans modified files, inspects git diffs, and synthesizes clean Conventional Commit messages (feat(scope): message).
• 🧪 Autonomous Test Runner: Executes unit test suites (npm test), parses stack traces, and iteratively fixes failing assertions.
• 💻 CLI Binary Executable (tui-code): Run tasks directly from your shell with termiagent "instruction".

graph TD
    A["⚡ Terminal Instruction Prompt"] --> B["🧠 TermiAgent Reasoning Engine (agentLoop)"]
    
    B --> C1["📂 File AST Reader"]
    B --> C2["📄 Unified Patch Generator (diffEngine)"]
    B --> C3["🧪 Test Runner & Validator"]

    C2 --> D["📄 Split Diff Viewer"]
    C3 --> E["🌿 Git Commit Synthesizer"]

    B --> F1["🦙 Ollama Local (Qwen 2.5 Coder)"]
    B --> F2["🧠 Claude 3.7 Sonnet"]
    B --> F3["🤖 OpenAI GPT-4o"]

npx termiagent

# Clone repository
git clone https://github.com/Nithinfgs/termiagent.git
cd termiagent

# Install dependencies
npm install

# Start TUI workspace
npm run dev

Open http://localhost:3003 in your browser.

# Launch interactive TUI console
termiagent

# Direct instruction mode
termiagent "Refactor login controller to use async/await"

# Launch on custom port
termiagent --port 8080

# View help
termiagent --help

Distributed under the MIT License. See LICENSE for details.