opencode-semantic-memory 0.5.0__tar.gz → 0.5.1__tar.gz

{opencode_semantic_memory-0.5.0 → opencode_semantic_memory-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opencode-semantic-memory
-Version: 0.5.0
+Version: 0.5.1
 Summary: Persistent semantic memory system for OpenCode sessions
 Author-email: Gregory Havenga <ghavenga@gitlab.com>
 License-Expression: MIT
@@ -57,6 +57,8 @@ opencode-memory is an MCP (Model Context Protocol) server that provides long-ter
 - **Entity tracking**: Links memories to MRs, issues, epics (!123, #456, &789)
 - **GitLab enrichment**: Fetches metadata for entities from GitLab API
 - **Memory age**: All outputs show age to identify potentially outdated information
+- **Proactive context injection**: Automatically injects relevant memories before each LLM call (OpenCode only, via plugin)
+- **Agent-agnostic LLM support**: Works with OpenCode, Claude CLI, GitLab Duo, Ollama, or custom commands
 
 ## Prerequisites
 
@@ -136,6 +138,40 @@ To enable LLM extraction (if you want it), add to `~/.config/opencode-memory/con
 llm_extraction = true
 ```
 
+### LLM Provider Configuration
+
+The memory system supports multiple LLM providers for knowledge extraction and session analysis. By default, it uses OpenCode, but you can configure alternatives:
+
+```toml
+# ~/.config/opencode-memory/config.toml
+
+# Option 1: OpenCode (default) - uses your configured OpenCode LLM
+[llm]
+provider = "opencode"
+
+# Option 2: Anthropic Claude CLI (requires claude-cli package)
+[llm]
+provider = "claude"
+model = "claude-sonnet-4-20250514"  # optional
+
+# Option 3: GitLab Duo CLI (requires glab with Duo enabled)
+[llm]
+provider = "duo"
+
+# Option 4: Ollama (local models)
+[llm]
+provider = "ollama"
+model = "qwen2.5:14b"  # or any model you have pulled
+
+# Option 5: Custom command
+[llm]
+provider = "custom"
+command = "my-llm-cli"
+args = ["--prompt"]  # prompt is appended after these args
+```
+
+**Note:** The proactive context injection feature (automatic memory loading) currently only works with OpenCode via the plugin system. Other LLM providers can still use all memory tools manually.
+
 ## Quick Start
 
 ### 1. Start the Memory Services
@@ -201,7 +237,37 @@ Add to `~/.config/opencode/opencode.json`:
 }
 ```
 
-### 3. Configure the Agent
+### 3. Enable Proactive Context Injection (OpenCode Only)
+
+The proactive context plugin automatically injects relevant memories before each LLM call, so the AI has historical context without needing explicit `memory_recall` calls.
+
+**Requirements:**
+- OpenCode (not supported with other LLM providers)
+- Node.js 20+ (for building the plugin)
+
+**Setup:**
+
+The setup script automatically builds and configures the plugin if Node.js 20+ is available. To verify or configure manually:
+
+```json
+// ~/.config/opencode/opencode.json
+{
+  "mcp": { ... },
+  "plugin": ["/path/to/opencode-memory-install/plugin"]
+}
+```
+
+**How it works:**
+1. User sends a message → Plugin extracts entities (!MR, #issue, @user)
+2. Plugin calls memory server for relevant context
+3. Context is injected into the system prompt before LLM call
+4. AI sees relevant history automatically
+
+**Note:** If you're using a different LLM provider (Claude, Duo, Ollama), you'll need to call memory tools explicitly - proactive injection only works with the OpenCode plugin.
+
+For more details, see the [plugin documentation](plugin/README.md).
+
+### 4. Configure the Agent
 
 Add to `~/.config/opencode/AGENTS.md`:
 

{opencode_semantic_memory-0.5.0 → opencode_semantic_memory-0.5.1}/README.md

@@ -22,6 +22,8 @@ opencode-memory is an MCP (Model Context Protocol) server that provides long-ter
 - **Entity tracking**: Links memories to MRs, issues, epics (!123, #456, &789)
 - **GitLab enrichment**: Fetches metadata for entities from GitLab API
 - **Memory age**: All outputs show age to identify potentially outdated information
+- **Proactive context injection**: Automatically injects relevant memories before each LLM call (OpenCode only, via plugin)
+- **Agent-agnostic LLM support**: Works with OpenCode, Claude CLI, GitLab Duo, Ollama, or custom commands
 
 ## Prerequisites
 
@@ -101,6 +103,40 @@ To enable LLM extraction (if you want it), add to `~/.config/opencode-memory/con
 llm_extraction = true
 ```
 
+### LLM Provider Configuration
+
+The memory system supports multiple LLM providers for knowledge extraction and session analysis. By default, it uses OpenCode, but you can configure alternatives:
+
+```toml
+# ~/.config/opencode-memory/config.toml
+
+# Option 1: OpenCode (default) - uses your configured OpenCode LLM
+[llm]
+provider = "opencode"
+
+# Option 2: Anthropic Claude CLI (requires claude-cli package)
+[llm]
+provider = "claude"
+model = "claude-sonnet-4-20250514"  # optional
+
+# Option 3: GitLab Duo CLI (requires glab with Duo enabled)
+[llm]
+provider = "duo"
+
+# Option 4: Ollama (local models)
+[llm]
+provider = "ollama"
+model = "qwen2.5:14b"  # or any model you have pulled
+
+# Option 5: Custom command
+[llm]
+provider = "custom"
+command = "my-llm-cli"
+args = ["--prompt"]  # prompt is appended after these args
+```
+
+**Note:** The proactive context injection feature (automatic memory loading) currently only works with OpenCode via the plugin system. Other LLM providers can still use all memory tools manually.
+
 ## Quick Start
 
 ### 1. Start the Memory Services
@@ -166,7 +202,37 @@ Add to `~/.config/opencode/opencode.json`:
 }
 ```
 
-### 3. Configure the Agent
+### 3. Enable Proactive Context Injection (OpenCode Only)
+
+The proactive context plugin automatically injects relevant memories before each LLM call, so the AI has historical context without needing explicit `memory_recall` calls.
+
+**Requirements:**
+- OpenCode (not supported with other LLM providers)
+- Node.js 20+ (for building the plugin)
+
+**Setup:**
+
+The setup script automatically builds and configures the plugin if Node.js 20+ is available. To verify or configure manually:
+
+```json
+// ~/.config/opencode/opencode.json
+{
+  "mcp": { ... },
+  "plugin": ["/path/to/opencode-memory-install/plugin"]
+}
+```
+
+**How it works:**
+1. User sends a message → Plugin extracts entities (!MR, #issue, @user)
+2. Plugin calls memory server for relevant context
+3. Context is injected into the system prompt before LLM call
+4. AI sees relevant history automatically
+
+**Note:** If you're using a different LLM provider (Claude, Duo, Ollama), you'll need to call memory tools explicitly - proactive injection only works with the OpenCode plugin.
+
+For more details, see the [plugin documentation](plugin/README.md).
+
+### 4. Configure the Agent
 
 Add to `~/.config/opencode/AGENTS.md`:
 

{opencode_semantic_memory-0.5.0 → opencode_semantic_memory-0.5.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "opencode-semantic-memory"
-version = "0.5.0"
+version = "0.5.1"
 description = "Persistent semantic memory system for OpenCode sessions"
 readme = "README.md"
 license = "MIT"

{opencode_semantic_memory-0.5.0 → opencode_semantic_memory-0.5.1}/scripts/setup.sh

@@ -330,6 +330,127 @@ path = "~/.local/share/opencode-memory"
 EOF
 fi
 
+# =============================================================================
+# LLM PROVIDER CONFIGURATION
+# =============================================================================
+
+configure_llm_provider() {
+    local CONFIG_FILE="$CONFIG_DIR/config.toml"
+    
+    # Check if LLM is already configured
+    if grep -q '^\[llm\]' "$CONFIG_FILE" 2>/dev/null; then
+        info "LLM provider already configured"
+        return 0
+    fi
+    
+    echo ""
+    echo -e "${YELLOW}LLM Provider Configuration${NC}"
+    echo ""
+    echo "The memory system uses an LLM for knowledge extraction and session analysis."
+    echo "This is optional - basic memory functions work without it."
+    echo ""
+    echo "Supported providers:"
+    echo "  1. OpenCode (default) - Uses your configured OpenCode LLM"
+    echo "  2. Claude CLI         - Anthropic Claude (requires claude-cli)"
+    echo "  3. GitLab Duo         - GitLab Duo CLI (requires glab with Duo)"
+    echo "  4. Ollama             - Local models (requires ollama running)"
+    echo "  5. Skip               - Configure later or use without LLM features"
+    echo ""
+    
+    local choice
+    if [ -t 0 ]; then
+        read -p "Choice [1-5] (default: 1): " -n 1 -r choice
+        echo ""
+    else
+        info "Non-interactive mode: using OpenCode as default LLM provider"
+        choice="1"
+    fi
+    
+    case "${choice:-1}" in
+        1)
+            info "Configuring OpenCode as LLM provider..."
+            cat >> "$CONFIG_FILE" << 'EOF'
+
+[llm]
+provider = "opencode"
+EOF
+            ;;
+        2)
+            if command -v claude &> /dev/null; then
+                info "Configuring Claude CLI as LLM provider..."
+                cat >> "$CONFIG_FILE" << 'EOF'
+
+[llm]
+provider = "claude"
+# model = "claude-sonnet-4-20250514"  # Optional - uses CLI default
+EOF
+            else
+                warn "Claude CLI not found. Install with: pip install claude-cli"
+                warn "Falling back to OpenCode provider"
+                cat >> "$CONFIG_FILE" << 'EOF'
+
+[llm]
+provider = "opencode"
+EOF
+            fi
+            ;;
+        3)
+            if command -v glab &> /dev/null; then
+                info "Configuring GitLab Duo as LLM provider..."
+                cat >> "$CONFIG_FILE" << 'EOF'
+
+[llm]
+provider = "duo"
+EOF
+            else
+                warn "glab CLI not found. Install from: https://gitlab.com/gitlab-org/cli"
+                warn "Falling back to OpenCode provider"
+                cat >> "$CONFIG_FILE" << 'EOF'
+
+[llm]
+provider = "opencode"
+EOF
+            fi
+            ;;
+        4)
+            if command -v ollama &> /dev/null; then
+                info "Configuring Ollama as LLM provider..."
+                echo ""
+                read -p "Enter Ollama model name (default: qwen2.5:14b): " -r model_name
+                model_name="${model_name:-qwen2.5:14b}"
+                cat >> "$CONFIG_FILE" << EOF
+
+[llm]
+provider = "ollama"
+model = "$model_name"
+EOF
+            else
+                warn "Ollama not found. Install from: https://ollama.ai"
+                warn "Falling back to OpenCode provider"
+                cat >> "$CONFIG_FILE" << 'EOF'
+
+[llm]
+provider = "opencode"
+EOF
+            fi
+            ;;
+        5)
+            info "Skipping LLM configuration - configure later in $CONFIG_FILE"
+            ;;
+        *)
+            info "Using OpenCode as default LLM provider"
+            cat >> "$CONFIG_FILE" << 'EOF'
+
+[llm]
+provider = "opencode"
+EOF
+            ;;
+    esac
+}
+
+# Run LLM provider configuration
+configure_llm_provider
+
 # Setup service based on OS
 setup_linux_service() {
     local SYSTEMD_DIR="$HOME/.config/systemd/user"