feat!: use sqlite for all commands (#129)

Blocked by #128.

Author: ilbertt

context_use/cli/app.py

@@ -22,11 +22,9 @@
     "  context-use quickstart                       "
     "Preview with last 30 days, real-time API\n"
     "\n"
-    "Full pipeline (requires PostgreSQL):\n"
-    "  1. context-use config set-store postgres     "
-    "Set up PostgreSQL (one-time)\n"
-    "  2. context-use pipeline                      "
-    "Ingest → memories (batch API)\n"
+    "Full pipeline (batch API):\n"
+    "  context-use pipeline                         "
+    "Ingest + memories in one go\n"
     "\n"
     "Or step by step:\n"
     "  1. context-use ingest                        "
@@ -42,7 +40,7 @@
     "  context-use memories export                  "
     "Export to file\n"
     "\n"
-    "Personal agent (requires PostgreSQL + adk extra):\n"
+    "Personal agent (requires adk extra):\n"
     "  1. uv sync --extra adk                       "
     "Install the ADK extra\n"
     "  2. context-use config set-agent adk          "
@@ -61,8 +59,8 @@
     "Show current settings\n"
     "  context-use config set-key                   "
     "Change OpenAI API key\n"
-    "  context-use config set-store postgres        "
-    "Set up PostgreSQL\n"
+    "  context-use config set-store <backend>       "
+    "Switch store (sqlite)\n"
     "  context-use config path                      "
     "Print config file location\n"
 )

context_use/cli/base.py

@@ -46,10 +46,7 @@ def providers() -> list[str]:
 
 
 def require_api_key(cfg: Config) -> None:
-    """Exit with guidance if no API key is configured (no interactive prompt).
-
-    Used by all PostgreSQL commands where the key must be pre-configured.
-    """
+    """Exit with guidance if no API key is configured (no interactive prompt)."""
     if cfg.openai_api_key:
         return
     out.error(
@@ -59,20 +56,6 @@ def require_api_key(cfg: Config) -> None:
     sys.exit(1)
 
 
-def require_persistent(cfg: Config, command: str) -> None:
-    """Exit with guidance if the store backend is not PostgreSQL."""
-    if cfg.store_provider == "postgres":
-        return
-    out.error(f"'{command}' requires PostgreSQL for persistent storage.")
-    print()
-    out.info("To try context-use without a database:")
-    out.next_step("context-use quickstart")
-    print()
-    out.info("To set up PostgreSQL:")
-    out.next_step("context-use config set-store postgres")
-    sys.exit(1)
-
-
 def ensure_api_key(cfg: Config) -> None:
     """Ensure an API key is present, prompting interactively if needed.
 
@@ -330,40 +313,23 @@ async def run(
         """Override with the command's actual logic."""
 
 
-class PersistentCommand(ContextCommand, ABC):
-    """Command that requires PostgreSQL.
+class ApiCommand(ContextCommand, ABC):
+    """Command that requires a configured OpenAI API key.
 
-    ``_prepare`` enforces ``require_persistent`` before a context is built.
-    Subclasses should set ``display_name`` to the full CLI path shown in the
-    error message (e.g. ``"memories list"``).
+    ``_prepare`` enforces ``require_api_key`` before a context is built.
     """
 
-    display_name: ClassVar[str] = ""
-
     def _prepare(self, cfg: Config, args: argparse.Namespace) -> Config:
-        require_persistent(cfg, self.display_name or self.name)
-        return super()._prepare(cfg, args)
-
-
-class PersistentApiCommand(PersistentCommand, ABC):
-    """Command that requires PostgreSQL **and** a configured OpenAI API key.
-
-    ``_prepare`` adds ``require_api_key`` on top of
-    :class:`PersistentCommand`'s checks.
-    """
-
-    def _prepare(self, cfg: Config, args: argparse.Namespace) -> Config:
-        cfg = super()._prepare(cfg, args)
         require_api_key(cfg)
-        return cfg
+        return super()._prepare(cfg, args)
 
 
-class AgentCommand(PersistentApiCommand, ABC):
-    """Command that requires PostgreSQL, an OpenAI API key, **and** a configured
+class AgentCommand(ApiCommand, ABC):
+    """Command that requires an OpenAI API key **and** a configured
     agent backend.
 
     ``_prepare`` adds ``require_agent_backend`` on top of
-    :class:`PersistentApiCommand`'s checks.
+    :class:`ApiCommand`'s checks.
     """
 
     def _prepare(self, cfg: Config, args: argparse.Namespace) -> Config:
@@ -373,15 +339,13 @@ def _prepare(self, cfg: Config, args: argparse.Namespace) -> Config:
 
 
 class EphemeralApiCommand(ContextCommand, ABC):
-    """Command that always runs with an SQLite store and an OpenAI API key.
+    """Command that runs with a temporary SQLite store and an OpenAI API key.
 
-    Intended for zero-config preview flows (e.g. ``quickstart``) where no
-    database is needed or desired.
+    Intended for zero-config preview flows (e.g. ``quickstart``) where the
+    data does not need to persist beyond the session.
 
-    ``_prepare`` unconditionally sets ``store_provider = "sqlite"`` and then
-    calls ``ensure_api_key``, which prompts interactively when no key is
-    configured (unlike :class:`PersistentApiCommand` which exits with an
-    error).
+    ``_prepare`` points the database to a temporary file and then calls
+    ``ensure_api_key``, which prompts interactively when no key is configured.
     """
 
     llm_mode: ClassVar[str] = "sync"
@@ -404,7 +368,7 @@ class CommandGroup:
 
         class MemoriesGroup(CommandGroup):
             name = "memories"
-            help = "Manage memories (requires PostgreSQL)"
+            help = "Manage memories"
             subcommands = [
                 MemoriesGenerateCommand,
                 MemoriesListCommand,

context_use/cli/commands/agent.py

@@ -72,7 +72,6 @@ async def run(
 
 class AgentSynthesiseCommand(BaseAgentSkillCommand):
     name = "synthesise"
-    display_name = "agent synthesise"
     help = "Synthesise pattern memories from event memories"
     skill_name = "synthesise"
     header_text = "Synthesising memories"
@@ -94,7 +93,6 @@ async def run(
 
 class AgentUserProfileCommand(BaseAgentSkillCommand):
     name = "profile"
-    display_name = "agent profile"
     help = "Compile a first-person user profile from memories (printed to stdout)"
     skill_name = "profile"
     header_text = "Generating user profile"
@@ -106,7 +104,6 @@ class AgentUserProfileCommand(BaseAgentSkillCommand):
 
 class AgentAskCommand(AgentCommand):
     name = "ask"
-    display_name = "agent ask"
     help = "Send a free-form query to the personal agent"
 
     def add_arguments(self, parser: argparse.ArgumentParser) -> None:
@@ -146,7 +143,7 @@ async def run(
 
 class AgentGroup(CommandGroup):
     name = "agent"
-    help = "Run the personal memory agent (requires PostgreSQL + adk extra)"
+    help = "Run the personal memory agent (requires adk extra)"
     description = (
         "Run the personal memory agent with a built-in skill or a free-form query. "
         "Configure a backend first with: context-use config set-agent adk"

context_use/cli/commands/config.py

@@ -48,8 +48,10 @@ def badge(attr: str) -> str:
 
         if cfg.store_provider == "postgres":
             store_val = f"postgres ({cfg.db_host}:{cfg.db_port}/{cfg.db_name})"
+        elif cfg.store_provider == "sqlite":
+            store_val = f"sqlite ({cfg.db_path})"
         else:
-            store_val = "memory (in-memory, no persistence)"
+            store_val = cfg.store_provider
         out.kv("Store", f"{store_val} {badge('store_provider')}")
 
         if cfg.agent_backend:
@@ -70,8 +72,7 @@ def badge(attr: str) -> str:
         print()
         out.info("To change settings:")
         out.next_step("context-use config set-key", "change OpenAI API key")
-        out.next_step("context-use config set-store postgres", "set up PostgreSQL")
-        out.next_step("context-use config set-store memory", "switch to in-memory")
+        out.next_step("context-use config set-store sqlite", "use SQLite (default)")
         out.next_step("context-use config set-agent adk", "configure agent backend")
         print()
 
@@ -252,10 +253,10 @@ async def execute(self, args: argparse.Namespace) -> None:
         if backend == "adk":
             out.info("Requires the adk extra: uv sync --extra adk")
 
-        if not cfg.uses_postgres:
-            out.warn("The agent requires PostgreSQL for persistent storage.")
+        if cfg.store_provider not in ("sqlite", "postgres"):
+            out.warn("The agent requires a persistent store (sqlite or postgres).")
             out.info("Set it up first with:")
-            out.next_step("context-use config set-store postgres")
+            out.next_step("context-use config set-store sqlite")
             print()
 
         print()

context_use/cli/commands/ingest.py

@@ -5,7 +5,7 @@
 
 from context_use.cli import output as out
 from context_use.cli.base import (
-    PersistentCommand,
+    ContextCommand,
     add_archive_args,
     print_ingest_result,
     resolve_archive,
@@ -16,13 +16,12 @@
     from context_use import ContextUse
 
 
-class IngestCommand(PersistentCommand):
+class IngestCommand(ContextCommand):
     name = "ingest"
-    help = "Step 1: Process a data export archive (requires PostgreSQL)"
+    help = "Step 1: Process a data export archive"
     description = (
         "Process a data export archive. Run without arguments to "
-        "interactively pick from archives in data/input/. "
-        "Requires PostgreSQL."
+        "interactively pick from archives in data/input/."
     )
 
     def add_arguments(self, parser: argparse.ArgumentParser) -> None:

context_use/cli/commands/memories.py

@@ -14,9 +14,9 @@
     from context_use.models.memory import MemorySummary
 
 from context_use.cli.base import (
+    ApiCommand,
     CommandGroup,
-    PersistentApiCommand,
-    PersistentCommand,
+    ContextCommand,
     run_batches,
 )
 from context_use.config import Config
@@ -57,9 +57,8 @@ def export_memories_json(memories: list[MemorySummary], path: Path) -> None:
     path.write_text(json.dumps(rows, indent=2, ensure_ascii=False), encoding="utf-8")
 
 
-class MemoriesGenerateCommand(PersistentApiCommand):
+class MemoriesGenerateCommand(ApiCommand):
     name = "generate"
-    display_name = "memories generate"
     help = "Step 2: Generate memories from ingested archives (batch API)"
 
     async def run(
@@ -101,9 +100,8 @@ async def run(
         print()
 
 
-class MemoriesListCommand(PersistentCommand):
+class MemoriesListCommand(ContextCommand):
     name = "list"
-    display_name = "memories list"
     help = "List memories"
 
     def add_arguments(self, parser: argparse.ArgumentParser) -> None:
@@ -140,9 +138,8 @@ async def run(
             print()
 
 
-class MemoriesSearchCommand(PersistentApiCommand):
+class MemoriesSearchCommand(ApiCommand):
     name = "search"
-    display_name = "memories search"
     help = "Semantic search over memories"
 
     def add_arguments(self, parser: argparse.ArgumentParser) -> None:
@@ -184,9 +181,8 @@ async def run(
         print()
 
 
-class MemoriesGetCommand(PersistentCommand):
+class MemoriesGetCommand(ContextCommand):
     name = "get"
-    display_name = "memories get"
     help = "Show full details of a single memory"
 
     def add_arguments(self, parser: argparse.ArgumentParser) -> None:
@@ -215,9 +211,8 @@ async def run(
         print()
 
 
-class MemoriesUpdateCommand(PersistentApiCommand):
+class MemoriesUpdateCommand(ApiCommand):
     name = "update"
-    display_name = "memories update"
     help = "Edit the content or date range of a memory"
 
     def add_arguments(self, parser: argparse.ArgumentParser) -> None:
@@ -255,9 +250,8 @@ async def run(
         out.success(f"Updated memory {m.id}")
 
 
-class MemoriesCreateCommand(PersistentApiCommand):
+class MemoriesCreateCommand(ApiCommand):
     name = "create"
-    display_name = "memories create"
     help = "Write a new memory to the store"
 
     def add_arguments(self, parser: argparse.ArgumentParser) -> None:
@@ -291,9 +285,8 @@ async def run(
         out.success(f"Created memory {m.id}")
 
 
-class MemoriesArchiveCommand(PersistentCommand):
+class MemoriesArchiveCommand(ContextCommand):
     name = "archive"
-    display_name = "memories archive"
     help = "Mark one or more memories as superseded"
 
     def add_arguments(self, parser: argparse.ArgumentParser) -> None:
@@ -325,9 +318,8 @@ async def run(
             out.warn(f"Not found: {', '.join(not_found)}")
 
 
-class MemoriesExportCommand(PersistentCommand):
+class MemoriesExportCommand(ContextCommand):
     name = "export"
-    display_name = "memories export"
     help = "Export memories to a file"
 
     def add_arguments(self, parser: argparse.ArgumentParser) -> None:
@@ -373,7 +365,7 @@ async def run(
 
 class MemoriesGroup(CommandGroup):
     name = "memories"
-    help = "Manage memories (requires PostgreSQL)"
+    help = "Manage memories"
     subcommands = [
         MemoriesGenerateCommand,
         MemoriesListCommand,