Prompt library (NEW)

June 7, 2026 · View on GitHub

⚡ TermMind

AI-Powered Terminal Assistant
Chat with GPT, Claude, Gemini, Mistral, and more — directly in your terminal.

Quick Start • Features • Providers • Commands • Architecture • Configuration • Contributing • Documentation • License

🖥️ Demo

How TermMind Works

$ termmind chat

  ╔═══════════════════════════════════╗
  ║      T e r m M i n d            ║
  ║   AI Terminal Assistant v2.0.0  ║
  ╚═══════════════════════════════════╝

Provider: ollama | Model: llama3.2 | Git: detected ✓

❯ Refactor this function to use a list comprehension

🤖 Thinking...
┌──────────────────────────────────────────────┐
│ Here's the refactored version using a list   │
│ comprehension:                               │
│                                              │
│   def get_urls(text):                        │
│       return [m.group(1) for line in text    │
│               for m in re.finditer(...)]     │
│                                              │
│ This is ~40% shorter and avoids the nested   │
│ append pattern.                              │
└──────────────────────────────────────────────┘

⚡ 1,247 tokens • 2.3s • \$0.000000

🚀 Quick Start

# Install
pip install termmind

# Or from source
git clone https://github.com/rudra496/termmind.git
cd termmind
pip install -e .

# Setup (first run)
termmind init

# Start chatting
termmind chat

# One-shot question
termmind ask "How do I reverse a list in Python?"

# Edit a file with AI
termmind edit main.py "Add type hints to all functions"

# Review code
termmind review src/

# Generate tests
termmind test utils.py --framework pytest

# Security scan (NEW)
termmind scan src/
termmind scan api.py --ai    # AI-powered deep review

# Generate code from description (NEW)
termmind generate api "REST API for blog with auth" -f fastapi
termmind generate test "user auth module" -o test_auth.py

# Pipe support (NEW)
cat error.log | termmind pipe
git diff | termmind ask "Summarize these changes"

# Prompt library (NEW)
termmind prompts list
termmind prompts use code-review

Docker

docker build -t termmind .
docker run -it --rm -v $(pwd):/workspace termmind chat

✨ Features

9 LLM Providers — OpenAI, Anthropic (Claude), Gemini, Mistral, Cohere, Groq, Together, OpenRouter, Ollama
Security Scanner — 15+ vulnerability detection rules + AI-powered deep review
AI Code Generation — Generate APIs, classes, tests, Dockerfiles from natural language
Prompt Library — 12+ built-in templates for code review, debugging, optimization, and more
Smart Autocomplete — Context-aware file, command, and action suggestions
Streaming Responses — Real-time markdown rendering with syntax highlighting
Smart Code Context — Automatically includes relevant files based on your query
File Editing — AI-powered edits with diff preview and undo
Code Review — Get constructive feedback on any file or directory
Test Generation — Generate pytest/unittest tests for any file
Refactoring Engine — 8 AI-powered operations (extract function, rename, simplify, etc.)
Git Integration — Status, diff, commit with AI-generated messages, branch management
Code Index — Parse 10+ languages, query functions/classes, persist across sessions
Session Management — Save, load, export conversations
Snippet Manager — Save, search, import/export reusable code blocks
Project Templates — Scaffold from 8 templates (FastAPI, Flask, Next.js, Django, etc.)
Voice Mode — Text-to-speech for AI responses (optional)
Cost Tracking — Token usage, cost estimation, budget alerts, provider comparison
Plugin System — Extend with custom plugins (TodoTracker, CodeStats, AutoCommit built-in)
Pipe Support — Process piped stdin with AI
5 Color Themes — Dark, Light, Solarized, Dracula, Monokai
Shell Completions — Bash, Zsh, Fish
Session Recording — Record, replay, and export sessions as HTML
ELI5 Mode — Simplified explanations for any topic
Multi-line Input — Shift+Enter for newlines

🚀 What's New in v3.0

Multi-Agent System — Orchestrate Researcher, Coder, Reviewer, Writer, Architect agents working together
Knowledge Base with RAG — Vector storage, document ingestion, semantic search, and retrieval-augmented generation
Event-Driven Architecture — Pub/sub event bus for decoupled communication
Caching Layer — LRU cache with TTL for chat responses and expensive operations
Middleware Chain — Interceptor pattern for request/response processing
Custom Exception Hierarchy — Structured error handling with specific exception types
Agent CLI Commands — termmind agent run, termmind agent chat, termmind agent list
Knowledge Base CLI Commands — termmind kb add, termmind kb query, termmind kb init, termmind kb stats
Workflow State Persistence — Save and load multi-agent workflow states as JSON

🌐 Providers

Provider	Free Tier	Local	Default Model
Ollama	✅ Free	✅ Yes	llama3.2
Groq	✅ Free	❌	llama-3.3-70b
Gemini	✅ Free	❌	gemini-2.0-flash
OpenAI	💰 Paid	❌	gpt-4o-mini
Anthropic	💰 Paid	❌	claude-sonnet-4
Mistral	💰 Paid	❌	mistral-small
Cohere	💰 Paid	❌	command-r-plus
Together	💰 Paid	❌	llama-3-70b
OpenRouter	💰 Varies	❌	gpt-4o-mini

Switch providers mid-conversation: /provider ollama

⌨️ Commands

File Operations

Command	Description
`/edit <file> [instruction]`	Edit a file with AI
`/run <cmd>`	Run a shell command
`/files`	List files in context
`/search <query>`	Search in project files
`/grep <pattern>`	Grep with regex
`/tree [--depth N]`	Show file tree
`/undo [--all]`	Undo last/all edits
`/diff [file]`	Show session changes

Chat & Session

Command	Description
`/clear`	Clear conversation
`/save [name]`	Save session
`/load [name]`	Load session
`/sessions`	List saved sessions
`/export [--json]`	Export conversation
`/compact`	Compact to save tokens

Provider & Model

Command	Description
`/model [name]`	Switch model
`/providers`	List all providers
`/cost`	Show usage & cost
`/cost compare`	Compare provider costs
`/cost optimize`	Suggest savings

Git

Command	Description
`/git status`	Git status
`/git diff`	Git diff
`/git log`	Recent commits
`/git commit`	AI-generated commit message
`/git checkout <branch>`	Switch branch

Advanced

Command	Description
`/refactor <op> <file>`	AI-powered refactoring
`/snippet save <name>`	Save a code snippet
`/template use <name>`	Scaffold a project
`/index`	Build code index
`/symbols [pattern]`	List functions/classes
`/record start`	Start session recording
`/voice on`	Enable text-to-speech
`/eli5 <topic>`	Explain Like I'm 5

CLI Commands

termmind chat          # Interactive chat session
termmind ask "..."     # One-shot question
termmind edit <file>   # Edit a file
termmind review <path> # Review code
termmind test <file>   # Generate tests
termmind explain <f>   # Explain a file
termmind debug <file>  # Debug a file
termmind refactor <f>  # Refactor a file
termmind docstring <f> # Add docstrings
termmind translate <f> # Translate comments
termmind scan <path>   # Security vulnerability scan (NEW)
termmind generate <t>  # AI code generation (NEW)
termmind pipe          # Process piped stdin (NEW)
termmind prompts list  # Prompt library (NEW)
termmind init          # Setup wizard
termmind config        # Show config
termmind index         # Build code index
termmind symbols       # List symbols
termmind doctors       # Health check
termmind completions   # Shell completions

# v3.0 — Multi-Agent Commands
termmind agent list                    # List available agent personas
termmind agent run "research-code" "Build a REST API"   # Run multi-agent workflow
termmind agent chat researcher "Explain quantum computing"  # Chat with specific persona

# v3.0 — Knowledge Base Commands
termmind kb init                       # Initialize knowledge base
termmind kb add ./docs --recursive     # Add documents to KB
termmind kb query "What is RAG?"      # Query with RAG
termmind kb list                       # List KB documents
termmind kb stats                      # Show KB statistics

🏗 Architecture

TermMind Architecture

🔧 Configuration

Config stored at ~/.termmind/config.json:

{
  "provider": "ollama",
  "api_key": "",
  "model": "llama3.2",
  "max_tokens": 4096,
  "temperature": 0.7,
  "theme": "dark",
  "auto_context": true,
  "max_context_files": 20,
  "confirm_edits": true,
  "stream": true
}

🤝 Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Fork the repository
Create your feature branch (git checkout -b feature/amazing)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing)
Open a Pull Request

📚 Documentation

Architecture — Module design and data flow
FAQ — Frequently asked questions
Changelog — Version history
Roadmap — Planned features
Support — Getting help
Examples — Usage examples

📄 License

MIT License — see LICENSE for details.

⭐ Star History

🔗 Connect

Built with ❤️ by Rudra Sarker