TermMind — AI-Powered Terminal Assistant | Multi-Provider CLI Coding Tool

A modern, open-source AI terminal assistant. Free, beautiful, and lives in your terminal.

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

What is TermMind?

TermMind is a CLI tool that lets you chat with AI models directly in your terminal. It can read, write, and edit files, run commands, understand your codebase, and help you code faster — all with a beautiful, rich terminal UI.

Think Claude Code or Aider, but free, open-source, and lightweight.

✨ Features

🎨 Beautiful terminal UI — Syntax highlighting, markdown rendering, streaming responses
🔌 Multi-provider — OpenAI, Anthropic Claude, Google Gemini, Groq, Together.ai, OpenRouter, Ollama
💰 Free tiers supported — Works with Gemini, Groq, and Ollama at zero cost
📁 Smart context — Automatically includes relevant files from your project
✏️ File editing — AI-powered file creation and editing with diff support
↩️ Undo system — Every edit is tracked; undo any change with /undo
💾 Session management — Save and load conversations
📊 Cost tracking — Real-time token count and cost estimation
🔄 Provider switching — Change models mid-conversation with /provider
🌳 File tree — Visual project structure with .termmindignore support
🔍 Code search — Find anything in your project files
🐙 Git integration — Status, diff, log, and AI-generated commit messages
⚡ Streaming — See responses as they're generated, not after
📦 Snippet Manager — Save, search, and reuse code snippets with template variables
🏗️ Project Templates — Scaffold projects from 8 built-in templates (Python, FastAPI, React, Next.js, etc.)
🔧 Refactoring Engine — AI-powered refactoring with diff preview, confirmation, and undo

🚀 Installation

pip install termmind

Or from source:

git clone https://github.com/rudra496/termmind.git
cd termmind
pip install -e .

🏁 Quick Start

1. Set up your API

termmind init

This walks you through selecting a provider and entering your API key. You can also manually edit ~/.termmind/config.json.

2. Start chatting

termmind chat

3. Ask questions

termmind ask "Explain async/await in Python"

4. Edit files

termmind edit main.py "Add input validation to the parse_args function"

5. Review code

termmind review ./src

📋 Commands

Command	Description
`termmind init`	Configure API provider, key, and model
`termmind chat`	Start interactive chat session
`termmind ask "q"`	One-shot question (no session)
`termmind edit file`	Edit a file with AI
`termmind review path`	Review code in directory
`termmind explain file`	Explain a file
`termmind test file`	Generate tests for a file
`termmind history`	Show saved sessions
`termmind config`	Show current configuration

Chat Commands

Inside termmind chat, use slash commands:

Command	Description
`/edit <file> [instruction]`	Edit a file with AI
`/run <command>`	Run a shell command
`/files`	List files in context
`/add <file>`	Add file to context
`/search <query>`	Search project files
`/tree`	Show file tree
`/clear`	Clear conversation
`/save [name]`	Save session
`/load <name>`	Load saved session
`/model [name]`	Show/switch model
`/provider [name]`	Show/switch provider
`/cost`	Show token usage & cost
`/theme dark/light`	Change color theme
`/undo`	Undo last file edit
`/diff`	Show session changes
`/status`	Git status + context info
`/git [status/log/diff]`	Git operations
`/snippet save <name>`	Save code as a snippet
`/snippet list`	List saved snippets
`/snippet load <name>`	Load snippet into context
`/snippet search <query>`	Search snippets
`/template list`	List project templates
`/template use <name>`	Scaffold a project
`/refactor <op> <file>`	AI-powered refactoring
`/refactor undo`	Undo last refactoring
`/help`	Show all commands

🔑 Provider Setup

🆓 Free Options (no cost)

Google Gemini

Go to aistudio.google.com
Create a free API key
Select gemini during termmind init

Groq

Go to console.groq.com
Sign up and create an API key
Super fast inference on open-source models

Ollama (fully offline)

Install: curl -fsSL https://ollama.ai/install.sh | sh
Pull a model: ollama pull llama3.2
No API key needed! Just select ollama during setup

💳 Paid Options

OpenAI

Go to platform.openai.com
Create an API key
Supports GPT-4o, GPT-4o-mini, etc.

OpenRouter

Go to openrouter.ai
Access 100+ models from one API key

⚙️ Configuration

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

{
  "provider": "gemini",
  "api_key": "your-key-here",
  "model": "gemini-2.0-flash",
  "max_tokens": 4096,
  "temperature": 0.7,
  "theme": "dark"
}

.termmindignore

Like .gitignore but for AI context. Create in your project root:

node_modules/
__pycache__/
*.min.js
dist/
.env

🆚 Comparison

Feature	TermMind	Claude Code	Aider	Open Interpreter
Open Source	✅ MIT	❌	✅ Apache	✅ MIT
Free Tier	✅ (Gemini/Groq)	❌	❌	❌
Local/Offline	✅ (Ollama)	❌	✅	✅
Streaming	✅	✅	✅	✅
Multi-Provider	✅ 6+	❌	✅	✅
Rich Terminal UI	✅	✅	❌	❌
File Editing	✅	✅	✅	✅
Undo Edits	✅	❌	✅	❌
Cost Tracking	✅	❌	❌	❌
Session Save/Load	✅	❌	❌	❌
Dependencies	4	Heavy	Moderate	Heavy
Python	✅ 3.8+	Node.js	Python	Python

🐳 Docker Quick Start

# Build and run
docker compose up --build

# With local Ollama (fully offline)
docker compose --profile local-llm up --build

# One-shot question via Docker
docker compose run --rm termmind ask "Explain async/await in Python"

🔧 Shell Completions

# Auto-install for your current shell
termmind completions install

# Or manually: generated scripts live in ~/.termmind/completions/
# Bash:
  echo 'source ~/.termmind/completions/termmind.bash' >> ~/.bashrc
# Zsh:
  echo 'fpath=(~/.termmind/completions $fpath)' >> ~/.zshrc
# Fish:
  cp ~/.termmind/completions/termmind.fish ~/.config/fish/completions/

🏗️ Architecture

┌─────────────────────────────────────────────┐
│                   CLI (cli.py)              │
│  click commands: chat, ask, edit, review…   │
└──────────┬──────────────┬───────────────────┘
           │              │
    ┌──────▼──────┐ ┌────▼──────────┐
    │  Commands    │ │  Diff Engine  │
    │  (/edit,…)   │ │  (diff_       │
    │  commands.py │ │   engine.py)  │
    └──────┬──────┘ └───────────────┘
           │
    ┌──────▼──────────────────────────┐
    │         Context Engine          │
    │  context.py + memory.py        │
    │  (smart file selection,        │
    │   code index, caching)         │
    └──────┬──────────────────────────┘
           │
    ┌──────▼──────┐ ┌───────────────┐
    │  File Ops    │ │  Git Module   │
    │  file_ops.py │ │  git.py       │
    └──────┬──────┘ └───────────────┘
           │
    ┌──────▼──────────────────────────┐
    │         API Client              │
    │  api.py + providers.py         │
    │  (streaming, multi-provider)    │
    └────────────────────────────────┘
           │
    ┌──────▼──────────────────────────┐
    │       Plugin System              │
    │  plugins.py (on_start, on_msg…) │
    └────────────────────────────────┘

✨ What Makes TermMind Unique

These features set TermMind apart from every other AI coding assistant:

🎨 Smart Diff Preview System

Side-by-side diff view in the terminal with rich syntax highlighting
Hunk-by-hunk confirmation — accept or reject individual changes
Auto-detect edit type — insert, delete, replace, move, rename
Multi-file diff statistics — insertions, deletions, files changed
Beautiful colored output (red for removals, green for additions)

🧠 Code Context Memory

Persists across sessions — remembers your project structure
Lightweight code index — function signatures, class definitions, imports
Incremental updates — only re-indexes changed files
9 languages supported — Python, JS, TS, Go, Rust, Java, Ruby, C, C++
Query the index — find functions/classes by name pattern instantly

🐚 Shell Integration

Auto-detect shell — bash, zsh, fish
Generate completion scripts for all three shells
Terminal capability detection — true color, Unicode, emoji, copy/paste
Auto-resize handling — responds to terminal resize events
One-command install — termmind completions install

📦 Snippet Manager

Save snippets from conversations — extracts code blocks automatically
Search by name, description, tags, or code content with relevance scoring
Template variables — {{filename}}, {{datetime}}, {{user}}, {{cwd}}, {{year}}, etc.
Auto-suggest relevant snippets based on conversation context
Import/Export — share snippet collections as JSON files
Usage tracking — tracks how often each snippet is used
Language detection — auto-detects programming language from content
Stored in ~/.termmind/snippets/ — portable and shareable

🏗️ Project Templates

8 built-in templates — scaffold complete projects instantly:
- python-package — Modern Python package with pyproject.toml, tests, CI
- fastapi-api — FastAPI REST API with auth, DB, Docker
- flask-api — Flask REST API with SQLAlchemy
- cli-tool — Python CLI tool with click
- react-app — React + TypeScript + Vite
- nextjs-app — Next.js with App Router
- express-api — Express.js REST API
- django-app — Django with Django REST Framework
Template variables — {{project_name}}, {{module_name}}, {{author}}, etc.
Custom templates — add your own to ~/.termmind/templates/
Post-generation instructions — clear next steps for each template

🔧 Refactoring Engine

8 refactoring operations — extract-function, rename, inline, extract-class, simplify, dead-code, sort-imports, add-types
AI-powered — uses your configured model for intelligent refactoring
Diff preview — see exactly what will change before applying
Confirmation step — approve or reject each refactoring
Undo support — every refactoring is tracked and reversible
History — view past refactorings with /refactor history
Local sort-imports — PEP 8 import sorting without AI needed

⚡ Performance

Operation	Time
Startup (cold)	~0.3s
Startup (warm)	~0.1s
Context selection (10 files)	~0.05s
Code index build (100 files)	~0.8s
Code index update (incremental)	~0.05s
Diff render (1000 lines)	~0.02s

Measured on a typical developer machine. Actual times vary.

🛠️ Development

# Clone
git clone https://github.com/rudra496/termmind.git
cd termmind

# Install in dev mode
pip install -e .

# Run directly
python -m termmind.cli chat

# Test
python -m pytest

# Docker dev environment
docker compose up --build

Project Structure

termmind/
├── termmind/
│   ├── __init__.py       # Version info
│   ├── cli.py            # Main CLI entry point
│   ├── api.py            # API client (streaming, multi-provider)
│   ├── config.py         # Configuration management
│   ├── context.py        # Smart file context builder
│   ├── commands.py       # Slash command handlers
│   ├── file_ops.py       # File read/write/edit/search
│   ├── git.py            # Git operations
│   ├── providers.py      # Provider implementations
│   ├── plugins.py        # Plugin system
│   ├── sessions.py       # Session save/load
│   ├── themes.py         # Color themes
│   ├── diff_engine.py    # Smart diff preview system
│   ├── memory.py         # Code context memory/index
│   ├── shell.py          # Shell integration & completions
│   ├── snippets.py       # Snippet manager (save/search/reuse)
│   ├── templates.py      # Project scaffolding templates
│   ├── refactor.py       # AI-powered refactoring engine
│   └── utils.py          # Token counting, utilities
├── tests/
├── Dockerfile
├── docker-compose.yml
├── pyproject.toml
├── README.md
├── CODE_OF_CONDUCT.md
├── SECURITY.md
├── CONTRIBUTING.md
└── LICENSE

🤝 Contributing

See CONTRIBUTING.md for detailed guidelines on:

Setting up the dev environment
Code style and conventions
Adding new providers and commands
Plugin development
Testing guidelines
PR and issue templates

📜 Code of Conduct

This project follows the Contributor Covenant Code of Conduct. By participating, you agree to uphold this standard.

🔒 Security

See SECURITY.md for our security policy, supported versions, and vulnerability reporting guidelines.

Quick start:

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

📄 License

MIT License — see LICENSE for details.

Made with ❤️ by the TermMind contributors

💡 Why TermMind?

7 providers, 1 tool — No need to switch between ChatGPT, Claude, Gemini apps
Code-aware — Understands your project structure, not just isolated files
Works offline — Use Ollama or local models with zero API costs
Extensible — Plugin system lets you add custom commands
Zero config — Works out of the box, configure only when you want to
Session history — Never lose context between sessions

👤 Who Uses This?

Role	How They Use It
Full-Stack Devs	Quick code generation, refactoring, and debugging across languages
DevOps Engineers	Generate Dockerfiles, CI configs, and Terraform files
Students	Learn programming with an AI tutor that explains concepts
Open Source Contributors	Understand unfamiliar codebases quickly
AI Enthusiasts	Experiment with multiple LLM providers side by side

🌐 Connect

Built with ❤️ by rudra496 · LinkedIn
_{MIT License · Free & Open Source Forever}

Name		Name	Last commit message	Last commit date
Latest commit History 12 Commits
.github		.github
termmind		termmind
tests		tests
.gitignore		.gitignore
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
docker-compose.yml		docker-compose.yml
pyproject.toml		pyproject.toml

Folders and files

Latest commit

History

Repository files navigation

TermMind — AI-Powered Terminal Assistant | Multi-Provider CLI Coding Tool

What is TermMind?

✨ Features

🚀 Installation

🏁 Quick Start

1. Set up your API

2. Start chatting

3. Ask questions

4. Edit files

5. Review code

📋 Commands

Chat Commands

🔑 Provider Setup

🆓 Free Options (no cost)

Google Gemini

Groq

Ollama (fully offline)

💳 Paid Options

OpenAI

OpenRouter

⚙️ Configuration

.termmindignore

🆚 Comparison

🐳 Docker Quick Start

🔧 Shell Completions

🏗️ Architecture

✨ What Makes TermMind Unique

🎨 Smart Diff Preview System

🧠 Code Context Memory

🐚 Shell Integration

📦 Snippet Manager

🏗️ Project Templates

🔧 Refactoring Engine

⚡ Performance

🛠️ Development

Project Structure

🤝 Contributing

📜 Code of Conduct

🔒 Security

📄 License

💡 Why TermMind?

👤 Who Uses This?

🌐 Connect

About

Topics

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 4

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

Packages