CliRecall is an AI-powered terminal command history and memory assistant for VS Code. It automatically captures, explains, and recalls terminal commands you execute in your workspace, keeping them private to you while utilizing MongoDB Atlas and LLM models.
Features
Automated Command Logging: Silently tracks commands run in your VS Code terminals, automatically masking credentials/secrets (tokens, passwords, API keys).
Private-by-Default: Each command is tied to your local VS Code installation, ensuring your history remains entirely private, even when using a shared MongoDB database.
AI-Generated Summaries: Automatically generates natural language explanations for your executed commands.
Quick Search: Instantly look up past commands by keyword, description, or project name via the VS Code Command Palette.
Ask AI Assistant: Chat with CliRecall AI directly from the sidebar webview. It uses your project context and command history to suggest the exact commands you need.
Extension Settings
Configure CliRecall by opening your VS Code settings and searching for:
commandMemory.mongodbUri: Optional MongoDB connection string (e.g., MongoDB Atlas) for cloud synchronization across machines. If left blank, CliRecall will automatically use a local, private SQLite database.
commandMemory.llmApiKey: API Key for your LLM provider (e.g. Gemini, NVIDIA NIM, OpenAI, DeepSeek).
commandMemory.llmBaseUrl: Base URL for the OpenAI-compatible AI API (defaults to https://integrate.api.nvidia.com/v1).
commandMemory.llmModel: The AI Model to use for generating summaries and answering questions (defaults to meta/llama-3.1-8b-instruct).
Usage
1. View and Search in the Sidebar
Click on the CliRecall icon in the Activity Bar to open the sidebar. Here, you can:
Ask AI: Input a natural language prompt (e.g., "how do I run tests on this project") to receive context-aware command suggestions.
Search: Start typing in the search bar to query your past command history.
Recent History: View, copy, or click to run recent commands.
2. Search via Command Palette
Press Ctrl+Shift+P (or Cmd+Shift+P on macOS) and run:
Command Memory: Search - Performs a fuzzy search of your commands and allows you to copy or execute them directly.
Command Memory: Ask - Prompt the AI assistant from a quick input box.
Example Configurations
Google Gemini (AI Studio)
Base URL: https://generativelanguage.googleapis.com/v1beta/openai/
API Key: Your Gemini API Key from Google AI Studio
Model: gemini-1.5-flash or gemini-2.5-flash
OpenAI
Base URL: https://api.openai.com/v1
API Key: sk-proj-...
Model: gpt-4o-mini
Local Ollama
Base URL: http://localhost:11434/v1
API Key: ollama (any non-empty placeholder string)
