deja-cli 0.1.0__py3-none-any.whl

deja/llm/factory.py

@@ -0,0 +1,90 @@
+from __future__ import annotations
+
+import sys
+from typing import Literal, Optional
+
+import httpx
+
+from deja.config import Config, LLMProviderConfig
+from deja.llm.base import LLMAdapter
+from deja.llm.embedding import EmbeddingAdapter, OllamaEmbeddingAdapter
+from deja.llm.providers.anthropic import AnthropicAdapter
+from deja.llm.providers.ollama import OllamaAdapter
+
+
+async def _ollama_available(base_url: str) -> bool:
+    try:
+        async with httpx.AsyncClient(timeout=2.0) as client:
+            response = await client.get(f"{base_url.rstrip('/')}/api/tags")
+            return response.status_code == 200
+    except Exception:
+        return False
+
+
+def _build_adapter(provider_cfg: LLMProviderConfig) -> LLMAdapter:
+    if provider_cfg.provider == "ollama":
+        return OllamaAdapter(
+            model=provider_cfg.model,
+            base_url=provider_cfg.base_url,
+        )
+    elif provider_cfg.provider == "anthropic":
+        return AnthropicAdapter(
+            model=provider_cfg.model,
+            api_key=provider_cfg.api_key,
+        )
+    else:
+        raise ValueError(f"Unknown provider: {provider_cfg.provider}")
+
+
+async def create_adapter(
+    config: Config,
+    task: Literal["extraction", "reflection"] = "extraction",
+) -> Optional[LLMAdapter]:
+    """Create an LLM adapter for the given task.
+
+    Returns None when provider is 'none' — the agent handles extraction itself
+    via deja save, or the watcher falls back to saving raw content.
+    """
+    provider_cfg = (
+        config.llm.extraction if task == "extraction" else config.llm.reflection
+    )
+
+    if provider_cfg.provider == "none":
+        return None
+
+    if provider_cfg.provider == "ollama":
+        if await _ollama_available(provider_cfg.base_url):
+            return _build_adapter(provider_cfg)
+        else:
+            print(
+                f"[deja] Ollama unavailable at {provider_cfg.base_url}, "
+                f"falling back to {config.llm.fallback.provider}",
+                file=sys.stderr,
+            )
+            return _build_adapter(config.llm.fallback)
+
+    return _build_adapter(provider_cfg)
+
+
+async def create_embedding_adapter(config: Config) -> Optional[EmbeddingAdapter]:
+    """Create an embedding adapter for semantic search.
+
+    Returns None when provider is 'none' — search falls back to BM25 (FTS5) only.
+    """
+    if config.embedding.provider == "none":
+        return None
+
+    if config.embedding.provider == "ollama":
+        if await _ollama_available(config.embedding.base_url):
+            return OllamaEmbeddingAdapter(
+                model=config.embedding.model,
+                base_url=config.embedding.base_url,
+            )
+        print(
+            f"[deja] Ollama unavailable at {config.embedding.base_url} — embedding search disabled",
+            file=sys.stderr,
+        )
+        return None
+
+    print(f"[deja] Unknown embedding provider: {config.embedding.provider}", file=sys.stderr)
+    return None

deja/llm/providers/anthropic.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+import anthropic
+
+from deja.llm.base import LLMAdapter, LLMResponse
+
+
+class AnthropicAdapter(LLMAdapter):
+    def __init__(self, model: str, api_key: str | None = None) -> None:
+        self.model = model
+        self._client = anthropic.AsyncAnthropic(api_key=api_key)
+
+    async def complete(self, system: str, user: str, **kwargs) -> LLMResponse:
+        message = await self._client.messages.create(
+            model=self.model,
+            max_tokens=4096,
+            system=system,
+            messages=[{"role": "user", "content": user}],
+        )
+        content = message.content[0].text
+        return LLMResponse(content=content, raw=message)

deja/llm/providers/ollama.py

@@ -0,0 +1,30 @@
+from __future__ import annotations
+
+import httpx
+
+from deja.llm.base import LLMAdapter, LLMResponse
+
+
+class OllamaAdapter(LLMAdapter):
+    def __init__(self, model: str, base_url: str = "http://localhost:11434") -> None:
+        self.model = model
+        self.base_url = base_url.rstrip("/")
+
+    async def complete(self, system: str, user: str, **kwargs) -> LLMResponse:
+        payload = {
+            "model": self.model,
+            "messages": [
+                {"role": "system", "content": system},
+                {"role": "user", "content": user},
+            ],
+            "stream": False,
+        }
+        async with httpx.AsyncClient(timeout=120.0) as client:
+            response = await client.post(
+                f"{self.base_url}/api/chat",
+                json=payload,
+            )
+            response.raise_for_status()
+            data = response.json()
+            content = data["message"]["content"]
+            return LLMResponse(content=content, raw=data)

deja/main.py

@@ -0,0 +1,4 @@
+from deja.interfaces.cli import app
+
+if __name__ == "__main__":
+    app()

deja_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: deja-cli
+Version: 0.1.0
+Summary: Local-first persistent memory CLI for coding agents
+Author-email: Mike <mike@bigtreeproduction.com>
+License: MIT
+License-File: LICENSE
+Keywords: agent,claude,cli,developer-tools,llm,memory
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Requires-Dist: aiosqlite>=0.20
+Requires-Dist: anthropic>=0.34
+Requires-Dist: apscheduler<4.0,>=3.10
+Requires-Dist: fastapi>=0.115
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp>=1.26.0
+Requires-Dist: pydantic-settings>=2.4
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-ulid>=2.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: typer>=0.12
+Requires-Dist: uvicorn[standard]>=0.30
+Requires-Dist: watchdog>=4.0
+Description-Content-Type: text/markdown
+
+# deja
+
+Local-first persistent memory CLI for coding agents. Memories accumulate across sessions, deduplicate automatically, and stay on your machine.
+
+## Install
+
+```bash
+uv tool install deja-cli
+```
+
+## Quick Start
+
+```bash
+deja init                        # first-time setup
+deja setup claude-code           # inject memory instructions into Claude Code
+```
+
+## Core Commands
+
+**Save a memory:**
+```bash
+deja save "Always use explicit error handling over try/catch" --type preference
+deja save "Auth tokens stored in localStorage, not cookies" --type decision --project myapp
+deja save "Prisma migrations fail silently if DB_URL has wrong port" --type gotcha --project myapp
+```
+
+**Load at session start:**
+```bash
+deja load --project myapp --context "what you're working on"
+```
+
+**Search mid-session:**
+```bash
+deja search "authentication" --project myapp
+```
+
+**Extract memories from a session:**
+```bash
+deja save-session --project myapp
+```
+
+## Memory Types
+
+| Type | When to use |
+|---|---|
+| `preference` | How you like to code — style, tools, habits |
+| `pattern` | Reusable solution that applies across contexts |
+| `decision` | Non-obvious architectural choice with reasoning |
+| `gotcha` | Bug, trap, or non-obvious issue to avoid |
+| `progress` | Current state of in-progress work |
+| `procedure` | Ordered steps for a recurring task |
+
+## Setup for Coding Agents
+
+```bash
+deja setup claude-code     # Claude Code — global config + recall hooks
+deja setup gemini-cli      # Gemini CLI
+deja setup codex           # Codex CLI
+deja setup cursor          # Cursor
+```
+
+## MCP Server
+
+```bash
+claude mcp add --scope user deja -- ~/.local/bin/deja-mcp
+```
+
+Registers `memory_load`, `memory_save`, and `memory_search` as native tools in every Claude Code session.

deja_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,31 @@
+deja/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+deja/config.py,sha256=0QVDDA4xKNz6PbefZ2rIq4kH0VDmf09F4eqJd14erKw,3874
+deja/main.py,sha256=nni8Tguta7JFkjcCbjy-fDZIn02dCzkEbUw9wnbOoWs,74
+deja/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+deja/core/extractor.py,sha256=p40C6NJaSmwTw5dZN05R7n298E_6kBrPp2JOYxOR05s,4742
+deja/core/reflection.py,sha256=IUgzaSZsgxRRnqJ2cFvxiG91HlpIWtFk8Kl3C5fbmc0,15721
+deja/core/scheduler.py,sha256=uTFKZaCv4HWp_thYr4DMK4QoO535l6In_prfPcch9xk,1835
+deja/core/store.py,sha256=2uMhX63BPFfRCV7RDjkNAXR5vJ0W2l32NL5nbadi03A,57378
+deja/ingest/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+deja/ingest/watchers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+deja/ingest/watchers/base.py,sha256=0EnjNf96fHE-_YGZHzJuc4EkQFKNYQoxxA020_fhY3E,4950
+deja/ingest/watchers/claude_code.py,sha256=lo_MpQf3F_dvSSjyhKFfaUXvyUXqNwUpkXCh5FRWBmY,2674
+deja/ingest/watchers/codex_cli.py,sha256=Btj9FBA69nyHvpi5iDXHdfBIYbe9HMtZRMCq3yqUIIM,3458
+deja/ingest/watchers/gemini_cli.py,sha256=bIEvPTWjniofdFxanN7cY44U1GFqLU74UzX-PA44C6g,3350
+deja/interfaces/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+deja/interfaces/cli.py,sha256=oiafmZOHoSD6MDxkmoM7HfptVGfuP__anvk-oJd8wRA,76808
+deja/interfaces/mcp_server.py,sha256=zo0Q1aHEmfM82jk6P-FacxYsPuhSSyH32YAgJq2OfuA,3198
+deja/interfaces/web.py,sha256=2emjKBVTXhrIaxhw59RI5X1c8mV14sVJ4IIXERcbPwo,3136
+deja/interfaces/web_ui/index.html,sha256=TE3JKlfqcli-dLfEcwR5eN5eNyMZd0YtmJYbdf_Ptis,17817
+deja/llm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+deja/llm/base.py,sha256=bkkN-ylKfTJNOt756Y7YQO45RIbm23ttT7aS8g2UxhA,1062
+deja/llm/embedding.py,sha256=gsZzU8hQFnfmk0i4yea9eRFzfGwG6QX9oSpR0wCh4OQ,1407
+deja/llm/factory.py,sha256=Kmd4oRLqTPFFwAE1Wo5p9GBSN7HfdALgrmHU7b3H6_s,2972
+deja/llm/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+deja/llm/providers/anthropic.py,sha256=Gmb6vjGN23vbLUBUdRTsFbcV9ndhaV3CcTgF6DICRkQ,693
+deja/llm/providers/ollama.py,sha256=b0v8MJcOL7fV_zd5r1LKHXpRHBnpjMia-B2PNWVoYUs,988
+deja_cli-0.1.0.dist-info/METADATA,sha256=Y1BIgPw1hyv2cy4tjvZPca4FVRnPX034VbGAU2vqaCY,2880
+deja_cli-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+deja_cli-0.1.0.dist-info/entry_points.txt,sha256=1DFYa8oXV00iBZk-Yc4ZKOMhTmQGhI1qHtGfdOXA1dY,82
+deja_cli-0.1.0.dist-info/licenses/LICENSE,sha256=bnwiEGciwVH_xm0PryA1FV7KGtkZMfVnnGdziRwI3u8,1061
+deja_cli-0.1.0.dist-info/RECORD,,

deja_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

deja_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+deja = deja.main:app
+deja-mcp = deja.interfaces.mcp_server:main

deja_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mike
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.