CodeCompanion History Extension

A history management extension for codecompanion.nvim that enables saving, browsing and restoring chat sessions.

✨ Features

🤖 Chat Management

• 💾 Flexible chat saving:
  • Automatic session saving (can be disabled)
  • Manual save with dedicated keymap
• 🎯 Smart title generation for chats
• 🔄 Continue from where you left
• 📚 Browse saved chats with preview
• 🔍 Multiple picker interfaces
• ⌛ Optional automatic chat expiration
• ⚡ Restore chat sessions with full context and tools state
• 🏢 Project-aware filtering: Filter chats by workspace/project context
• 📋 Chat duplication: Easily duplicate chats to create variations or backups

📝 Summary System

• Manual summary generation: Create summaries for any chat with gcs
• Intelligent content processing: Extracts meaningful conversation content while filtering noise
• Chunked summarization: Handles large conversations by splitting into manageable chunks
• Customizable generation: Configure adapter, model, and system prompts
• Summary browsing: Dedicated browser with gbs to explore all summaries

🧠 Memory System (@memory tool)

• Vector-based search: Uses VectorCode CLI to index and search through chat summaries
• Automatic indexing: Optionally index summaries as they are generated
• Smart integration: Available as @memory tool in new chats when VectorCode is installed

The following CodeCompanion features are preserved when saving and restoring chats:

| Feature | Status | Notes | |---------|--------|-------| | System Prompts | ✅ | System prompt used in the chat | | Messages History | ✅ | All messages | | Images | ✅ | Restores images as base64 strings | | LLM Adapter | ✅ | The specific adapter used for the chat | | LLM Settings | ✅ | Model, temperature and other adapter settings | | Tools | ✅ | Tool schemas and their system prompts | | Tool Outputs | ✅ | Tool execution results | | Variables | ✅ | Variables used in the chat | | References | ✅ | Code snippets and command outputs added via slash commands | | Pinned References | ✅ | Pinned references | | Watchers | ⚠ | Saved but requires original buffer context to resume watching |

When restoring a chat:

1. The complete message history is recreated
2. All tools and references are reinitialized
3. Original LLM settings and adapter are restored
4. Previous system prompts are preserved

Note: While watched buffer states are saved, they require the original buffer context to resume watching functionality.

[!NOTE] As this is an extension that deeply integrates with CodeCompanion's internal APIs, occasional compatibility issues may arise when CodeCompanion updates. If you encounter any bugs or unexpected behavior, please raise an issue to help us maintain compatibility.

📋 Requirements

• Neovim >= 0.8.0
• codecompanion.nvim
• VectorCode CLI (optional, for @memory tool)
• snacks.nvim (optional, for enhanced picker)
• telescope.nvim (optional, for enhanced picker)
• fzf-lua (optional, for enhanced picker)

📦 Installation

Using lazy.nvim:

First install the plugin

{
    "olimorris/codecompanion.nvim",
    dependencies = {
        --other plugins
        "ravitemer/codecompanion-history.nvim"
    }
}

Add history extension to CodeCompanion config

require("codecompanion").setup({
    extensions = {
        history = {
            enabled = true,
            opts = {
                -- Keymap to open history from chat buffer (default: gh)
                keymap = "gh",
                -- Keymap to save the current chat manually (when auto_save is disabled)
                save_chat_keymap = "sc",
                -- Save all chats by default (disable to save only manually using 'sc')
                auto_save = true,
                -- Number of days after which chats are automatically deleted (0 to disable)
                expiration_days = 0,
                -- Picker interface (auto resolved to a valid picker)
                picker = "telescope", --- ("telescope", "snacks", "fzf-lua", or "default") 
                ---Optional filter function to control which chats are shown when browsing
                chat_filter = nil, -- function(chat_data) return boolean end
                -- Customize picker keymaps (optional)
                picker_keymaps = {
                    rename = { n = "r", i = "<M-r>" },
                    delete = { n = "d", i = "<M-d>" },
                    duplicate = { n = "<C-y>", i = "<C-y>" },
                },
                ---Automatically generate titles for new chats
                auto_generate_title = true,
                title_generation_opts = {
                    ---Adapter for generating titles (defaults to current chat adapter) 
                    adapter = nil, -- "copilot"
                    ---Model for generating titles (defaults to current chat model)
                    model = nil, -- "gpt-4o"
                    ---Number of user prompts after which to refresh the title (0 to disable)
                    refresh_every_n_prompts = 0, -- e.g., 3 to refresh after every 3rd user prompt
                    ---Maximum number of times to refresh the title (default: 3)
                    max_refreshes = 3,
                    format_title = function(original_title)
                        -- this can be a custom function that applies some custom
                        -- formatting to the title.
                        return original_title
                    end
                },
                ---On exiting and entering neovim, loads the last chat on opening chat
                continue_last_chat = false,
                ---When chat is cleared with `gx` delete the chat from history
                delete_on_clearing_chat = false,
                ---Directory path to save the chats
                dir_to_save = vim.fn.stdpath("data") .. "/codecompanion-history",
                ---Enable detailed logging for history extension
                enable_logging = false,

                -- Summary system
                summary = {
                    -- Keymap to generate summary for current chat (default: "gcs")
                    create_summary_keymap = "gcs",
                    -- Keymap to browse summaries (default: "gbs")
                    browse_summaries_keymap = "gbs",
                    
                    generation_opts = {
                        adapter = nil, -- defaults to current chat adapter
                        model = nil, -- defaults to current chat model
                        context_size = 90000, -- max tokens that the model supports
                        include_references = true, -- include slash command content
                        include_tool_outputs = true, -- include tool execution results
                        system_prompt = nil, -- custom system prompt (string or function)
                        format_summary = nil, -- custom function to format generated summary e.g to remove <think/> tags from summary
                    },
                },
                
                -- Memory system (requires VectorCode CLI)
                memory = {
                    -- Automatically index summaries when they are generated
                    auto_create_memories_on_summary_generation = true,
                    -- Path to the VectorCode executable
                    vectorcode_exe = "vectorcode",
                    -- Tool configuration
                    tool_opts = { 
                        -- Default number of memories to retrieve
                        default_num = 10 
                    },
                    -- Enable notifications for indexing progress
                    notify = true,
                    -- Index all existing memories on startup
                    -- (requires VectorCode 0.6.12+ for efficient incremental indexing)
                    index_on_startup = false,
                },
            }
        }
    }
})

[!WARNING] Title and summary generation defaults to current chat's adapter and model. Make sure to set cheaper models in title_generation_opts and summary.generation_opts to avoid using premium models.

🛠️ Usage

🎯 Commands

• :CodeCompanionHistory - Open the history browser
• :CodeCompanionSummaries - Browse all summaries

⌨️ Chat Buffer Keymaps

History Management:

• gh - Open history browser (customizable via opts.keymap)
• sc - Save current chat manually (customizable via opts.save_chat_keymap)

Summary System:

• gcs - Generate summary for current chat (customizable via opts.summary.create_summary_keymap)
• gbs - Browse saved summaries (customizable via opts.summary.browse_summaries_keymap)

📚 History Browser

The history browser shows all your saved chats with:

• Title (au