keep-skill 0.7.0__tar.gz → 0.9.0__tar.gz

{keep_skill-0.7.0 → keep_skill-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: keep-skill
-Version: 0.7.0
+Version: 0.9.0
 Summary: Reflective memory - remember and search documents by meaning
 Project-URL: Homepage, https://github.com/hughpyle/keep
 Project-URL: Repository, https://github.com/hughpyle/keep
@@ -68,7 +68,7 @@ keep find "what's the rate limit?"
 
 # Track what you're working on
 keep now "Debugging auth flow"
-keep now -V 1                    # Previous context
+keep now -V 1                    # Previous intentions
 ```
 
 ---
@@ -128,12 +128,12 @@ keep get "ID@V{1}"                     # Same as -V 1 (version identifier)
 keep get ID --history                  # All versions
 
 # Tags
-keep tag project=myapp                 # Find by tag
-keep tag --list                        # List all tags
+keep list --tag project=myapp          # Find by tag
+keep list --tags=                      # List all tag keys
 
-# Current context
+# Current intentions
 keep now                               # Show what you're working on
-keep now "Fixing login bug"            # Update context
+keep now "Fixing login bug"            # Update intentions
 ```
 
 ### Python API

{keep_skill-0.7.0 → keep_skill-0.9.0}/README.md

@@ -17,7 +17,7 @@ keep find "what's the rate limit?"
 
 # Track what you're working on
 keep now "Debugging auth flow"
-keep now -V 1                    # Previous context
+keep now -V 1                    # Previous intentions
 ```
 
 ---
@@ -77,12 +77,12 @@ keep get "ID@V{1}"                     # Same as -V 1 (version identifier)
 keep get ID --history                  # All versions
 
 # Tags
-keep tag project=myapp                 # Find by tag
-keep tag --list                        # List all tags
+keep list --tag project=myapp          # Find by tag
+keep list --tags=                      # List all tag keys
 
-# Current context
+# Current intentions
 keep now                               # Show what you're working on
-keep now "Fixing login bug"            # Update context
+keep now "Fixing login bug"            # Update intentions
 ```
 
 ### Python API

{keep_skill-0.7.0 → keep_skill-0.9.0}/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: keep
-version: 0.7.0
+version: 0.9.0
 description: Reflective Memory
 homepage: https://github.com/hughpyle/keep
 runtime: python:3.12-slim
@@ -29,6 +29,15 @@ Before you can practice, ensure the practice is available in future sessions.
 1. Check if your system rules file contains the keep Protocol Block (look for `## keep: Reflective Memory`)
 2. If missing, append the Protocol Block
 
+**Global System Prompt Locations:**
+
+| Assistant | Location |
+|-----------|----------|
+| Claude Code | `~/.claude/CLAUDE.md` |
+| OpenAI Codex | `~/.codex/AGENTS.md` |
+
+Installing the Protocol Block at the global level makes it available across all projects. Prefer global installation when possible.
+
 **Protocol Block:**
 
 ```markdown
@@ -39,7 +48,7 @@ This work uses `keep` for memory and reflection, in order to become skillful.
 **Practice:** Before acting, check what you know. After acting, capture what you learned.
 
 \`\`\`bash
-keep now                     # Current context
+keep now                     # Current intentions
 keep find "topic"            # What do I know?
 keep update "learning"       # Capture insight
 \`\`\`
@@ -61,7 +70,7 @@ This skill provides memory. Use it — always, as practice.  Be skillful.
 
 Ground yourself:
 1. What kind of conversation is this? (Action? Possibility? Clarification?)
-2. Where am I? What's the current context?
+2. Where am I? What are my current intentions?
    ```bash
    keep now
    ```
@@ -117,7 +126,7 @@ This table is a summary. The full framework includes the Language-Action Perspec
 keep get "_system:conversations"
 ```
 
-The conversations document is foundational. It teaches you to recognize where you are in work, what stance to take, and how to notice when things shift. Internalize it.
+The 'conversations' document is foundational. It teaches you to recognize where you are in work, what stance to take, and how to notice when things shift. Internalize it.
 
 ### The Triple Check
 
@@ -137,7 +146,7 @@ keep update "Assumption was X, actually Y. Next time: Z" -t type=breakdown
 
 **Do this now — index the source teaching:**
 ```bash
-keep update "file://$PWD/docs/library/mn61.html" -t type=teaching -t topic=reflection --lazy
+keep update "file://$PWD/docs/library/mn61.html" -t type=teaching -t topic=reflection
 ```
 
 Then retrieve and read it:
@@ -169,7 +178,7 @@ You've read the core patterns (Layer 2). There's more foundational material.
 **Do this now — read and index:**
 ```bash
 keep get "_system:domains"
-keep update "file://$PWD/docs/library/true_person_no_rank.md" -t type=teaching -t topic=commentary --lazy
+keep update "file://$PWD/docs/library/true_person_no_rank.md" -t type=teaching -t topic=commentary
 keep get "file://$PWD/docs/library/true_person_no_rank.md"
 ```
 
@@ -185,21 +194,21 @@ The [docs/library/](docs/library/) directory contains additional seed material.
 
 ## Layer 4: Efficient Use
 
-### Track Your Current Context
+### Track Your Current Intentions
 
 Start each session by checking where you are:
 ```bash
 keep now
 ```
 
-Update it as your focus changes:
+Update it as your intentions change:
 ```bash
-keep now "Working on authentication bug in login flow"
+keep now "Improving the authentication flow; keep it simple"
 ```
 
 Check previous context if needed:
 ```bash
-keep now -V 1          # Previous context
+keep now -V 1          # Previous intentions
 keep now --history     # All versions
 ```
 
@@ -252,8 +261,8 @@ keep update "Token refresh fails if clock skew > 30s" -t domain=auth -t type=fin
 
 Later:
 ```bash
-keep tag domain=auth     # Everything about auth
-keep tag type=decision   # All decisions made
+keep list --tag domain=auth     # Everything about auth
+keep list --tag type=decision   # All decisions made
 ```
 
 **Suggested tag dimensions:**
@@ -290,8 +299,8 @@ Don't dump everything into context. Navigate the tree:
 
 | Command | Purpose | Example |
 |---------|---------|---------|
-| `now` | Get/set current context | `keep now` or `keep now "status"` |
-| `now -V N` | Previous context versions | `keep now -V 1` or `keep now --history` |
+| `now` | Get/set current intentions | `keep now` or `keep now "intention"` |
+| `now -V N` | Previous intentions versions | `keep now -V 1` or `keep now --history` |
 | `find` | Semantic similarity search | `keep find "authentication flow" --limit 5` |
 | `find --id` | Find similar to existing item | `keep find --id "docid" --limit 3` |
 | `search` | Full-text search in summaries | `keep search "OAuth"` |
@@ -300,29 +309,13 @@ Don't dump everything into context. Navigate the tree:
 | `get` | Retrieve item (shows similar items) | `keep get "file:///path/to/doc.md"` |
 | `get --similar` | List similar items | `keep get ID --similar` or `-n 20` for more |
 | `get -V N` | Previous versions | `keep get ID -V 1` or `keep get ID --history` |
-| `tag` | List tag values or find by tag | `keep tag domain=auth` or `keep tag --list` |
+| `list --tag` | Filter items by tag | `keep list --tag domain=auth` |
+| `list --tags` | List tag keys or values | `keep list --tags=` or `keep list --tags=domain` |
 | `tag-update` | Modify tags on existing item | `keep tag-update "id" --tag key=value` |
 | `collections` | List all collections | `keep collections` |
 | `init` | Initialize or verify store | `keep init` |
 | `config` | Show configuration and store path | `keep config` |
-| `process-pending` | Process lazy summaries | `keep process-pending --all` |
-
-### Fast Indexing with `--lazy`
-
-When using local models (MLX), summarization is slow. Use `--lazy` for fast indexing:
-
-```bash
-keep update "file:///path/to/doc.md" --lazy
-keep update "insight" -t type=learning --lazy
-```
-
-The `--lazy` flag:
-- Stores immediately with truncated placeholder
-- Spawns background processor automatically
-- Full summary generated asynchronously
-- Search works immediately (embeddings are synchronous)
-
-**Use `--lazy` when:** indexing many items, using local MLX models, or when you don't need the summary right away.
+| `process-pending` | Process pending summaries | `keep process-pending --all` |
 
 ### Output
 
@@ -360,7 +353,7 @@ keep -v find "auth"        # Debug logging
 Use `--ids` for Unix-style composition:
 ```bash
 keep --ids find "auth" | xargs keep get         # Get full details of matches
-keep --ids tag project=foo | xargs keep tag-update --tag status=done
+keep --ids list --tag project=foo | xargs keep tag-update --tag status=done
 keep --ids list | xargs -I{} keep get "{}"      # Get details for recent items
 ```
 

{keep_skill-0.7.0 → keep_skill-0.9.0}/keep/api.py

@@ -534,13 +534,17 @@ class Keeper:
         summary: Optional[str] = None,
         source_tags: Optional[dict[str, str]] = None,  # Deprecated alias
         collection: Optional[str] = None,
-        lazy: bool = False
     ) -> Item:
         """
         Insert or update a document in the store.
 
         Fetches the document, generates embeddings and summary, then stores it.
 
+        **Summary behavior:**
+        - If summary is provided, use it (skips auto-summarization)
+        - For large content, summarization is async (truncated placeholder
+          stored immediately, real summary generated in background)
+
         **Update behavior:**
         - Summary: Replaced with user-provided or newly generated summary
         - Tags: Merged - existing tags are preserved, new tags override
@@ -553,9 +557,6 @@ class Keeper:
             summary: User-provided summary (skips auto-summarization if given)
             source_tags: Deprecated alias for 'tags'
             collection: Target collection (uses default if None)
-            lazy: If True, use truncated placeholder summary and queue for
-                  background processing. Use `process_pending()` to generate
-                  real summaries later. Ignored if summary is provided.
 
         Returns:
             The stored Item with merged tags and new summary
@@ -615,17 +616,14 @@ class Keeper:
                 )
                 summary = summary[:max_len]
             final_summary = summary
-        elif lazy:
-            # Truncated placeholder for lazy mode
+        else:
+            # Large content: async summarization (truncated placeholder now, real summary later)
             if len(doc.content) > max_len:
                 final_summary = doc.content[:max_len] + "..."
+                # Queue for background processing
+                self._pending_queue.enqueue(id, coll, doc.content)
             else:
                 final_summary = doc.content
-            # Queue for background processing
-            self._pending_queue.enqueue(id, coll, doc.content)
-        else:
-            # Auto-generate summary
-            final_summary = self._get_summarization_provider().summarize(doc.content)
 
         # Build tags: existing → config → env → user (later wins on collision)
         merged_tags = {**existing_tags}
@@ -686,8 +684,8 @@ class Keeper:
                     tags=old_doc.tags,
                 )
 
-        # Spawn background processor if lazy (only if summary wasn't user-provided and content changed)
-        if lazy and summary is None and not content_unchanged:
+        # Spawn background processor if content was queued (large content, no user summary, content changed)
+        if summary is None and len(doc.content) > max_len and not content_unchanged:
             self._spawn_processor()
 
         # Return the stored item
@@ -703,7 +701,6 @@ class Keeper:
         tags: Optional[dict[str, str]] = None,
         source_tags: Optional[dict[str, str]] = None,  # Deprecated alias
         collection: Optional[str] = None,
-        lazy: bool = False
     ) -> Item:
         """
         Store inline content directly (without fetching from a URI).
@@ -713,7 +710,8 @@ class Keeper:
         **Smart summary behavior:**
         - If summary is provided, use it (skips auto-summarization)
         - If content is short (≤ max_summary_length), use content verbatim
-        - Otherwise, generate summary via summarization provider
+        - For large content, summarization is async (truncated placeholder
+          stored immediately, real summary generated in background)
 
         **Update behavior (when id already exists):**
         - Summary: Replaced with user-provided, content, or generated summary
@@ -728,9 +726,6 @@ class Keeper:
             tags: User-provided tags to merge with existing tags
             source_tags: Deprecated alias for 'tags'
             collection: Target collection (uses default if None)
-            lazy: If True and content is long, use truncated placeholder summary
-                  and queue for background processing. Ignored if content is
-                  short or summary is provided.
 
         Returns:
             The stored Item with merged tags and new summary
@@ -794,14 +789,11 @@ class Keeper:
         elif len(content) <= max_len:
             # Content is short enough - use verbatim (smart summary)
             final_summary = content
-        elif lazy:
-            # Content is long and lazy mode - truncated placeholder
+        else:
+            # Content is long - async summarization (truncated placeholder now, real summary later)
             final_summary = content[:max_len] + "..."
             # Queue for background processing
             self._pending_queue.enqueue(id, coll, content)
-        else:
-            # Content is long - generate summary
-            final_summary = self._get_summarization_provider().summarize(content)
 
         # Build tags: existing → config → env → user (later wins on collision)
         merged_tags = {**existing_tags}
@@ -860,8 +852,8 @@ class Keeper:
                     tags=old_doc.tags,
                 )
 
-        # Spawn background processor if lazy and content was queued (only if content changed)
-        if lazy and summary is None and len(content) > max_len and not content_unchanged:
+        # Spawn background processor if content was queued (large content, no user summary, content changed)
+        if summary is None and len(content) > max_len and not content_unchanged:
             self._spawn_processor()
 
         # Return the stored item
@@ -1366,14 +1358,14 @@ class Keeper:
 
     def get_now(self) -> Item:
         """
-        Get the current working context.
+        Get the current working intentions.
 
         A singleton document representing what you're currently working on.
         If it doesn't exist, creates one with default content and tags from
         the bundled system now.md file.
 
         Returns:
-            The current context Item (never None - auto-creates if missing)
+            The current intentions Item (never None - auto-creates if missing)
         """
         item = self.get(NOWDOC_ID)
         if item is None:
@@ -1394,13 +1386,13 @@ class Keeper:
         tags: Optional[dict[str, str]] = None,
     ) -> Item:
         """
-        Set the current working context.
+        Set the current working intentions.
 
-        Updates the singleton context with new content. Uses remember()
+        Updates the singleton intentions with new content. Uses remember()
         internally with the fixed NOWDOC_ID.
 
         Args:
-            content: New content for the current context
+            content: New content for the current intentions
             tags: Optional additional tags to apply
 
         Returns:
@@ -1554,6 +1546,7 @@ class Keeper:
         self,
         limit: int = 10,
         *,
+        since: Optional[str] = None,
         collection: Optional[str] = None,
     ) -> list[Item]:
         """
@@ -1561,16 +1554,24 @@ class Keeper:
 
         Args:
             limit: Maximum number to return (default 10)
+            since: Only include items updated since (ISO duration like P3D, or date)
             collection: Collection to query (uses default if not specified)
 
         Returns:
             List of Items, most recently updated first
         """
         coll = self._resolve_collection(collection)
-        records = self._document_store.list_recent(coll, limit)
 
-        return [_record_to_item(rec) for rec in records
-        ]
+        # Fetch extra when filtering by date
+        fetch_limit = limit * 3 if since is not None else limit
+        records = self._document_store.list_recent(coll, fetch_limit)
+        items = [_record_to_item(rec) for rec in records]
+
+        # Apply date filter if specified
+        if since is not None:
+            items = _filter_by_date(items, since)
+
+        return items[:limit]
 
     def embedding_cache_stats(self) -> dict:
         """

{keep_skill-0.7.0 → keep_skill-0.9.0}/keep/cli.py

@@ -47,6 +47,7 @@ def _verbose_callback(value: bool):
 _json_output = False
 _ids_output = False
 _full_output = False
+_store_override: Optional[Path] = None
 
 
 def _json_callback(value: bool):
@@ -76,6 +77,16 @@ def _get_full_output() -> bool:
     return _full_output
 
 
+def _store_callback(value: Optional[Path]):
+    global _store_override
+    if value is not None:
+        _store_override = value
+
+
+def _get_store_override() -> Optional[Path]:
+    return _store_override
+
+
 app = typer.Typer(
     name="keep",
     help="Reflective memory with semantic search.",
@@ -231,9 +242,16 @@ def main_callback(
         callback=_full_callback,
         is_eager=True,
     )] = False,
+    store: Annotated[Optional[Path], typer.Option(
+        "--store", "-s",
+        envvar="KEEP_STORE_PATH",
+        help="Path to the store directory",
+        callback=_store_callback,
+        is_eager=True,
+    )] = None,
 ):
     """Reflective memory with semantic search."""
-    # If no subcommand provided, show the current context (now)
+    # If no subcommand provided, show the current intentions (now)
     if ctx.invoked_subcommand is None:
         from .api import NOWDOC_ID
         kp = _get_keeper(None, "default")
@@ -401,9 +419,10 @@ def _format_items(items: list[Item], as_json: bool = False) -> str:
 
 def _get_keeper(store: Optional[Path], collection: str) -> Keeper:
     """Initialize memory, handling errors gracefully."""
-    # store=None is fine — Keeper will use default (git root/.keep)
+    # Check global override from --store on main command
+    actual_store = store if store is not None else _get_store_override()
     try:
-        return Keeper(store, collection=collection)
+        return Keeper(actual_store, collection=collection)
     except Exception as e:
         typer.echo(f"Error: {e}", err=True)
         raise typer.Exit(1)
@@ -464,6 +483,7 @@ def find(
     """
     Find items using semantic similarity search.
 
+    \b
     Examples:
         keep find "authentication"              # Search by text
         keep find --id file:///path/to/doc.md   # Find similar to item
@@ -509,71 +529,76 @@ def list_recent(
         "--limit", "-n",
         help="Number of items to show"
     )] = 10,
-):
-    """
-    List recent items by update time.
-
-    Default: summary lines. Use --ids for IDs only, --full for YAML.
-    """
-    kp = _get_keeper(store, collection)
-    results = kp.list_recent(limit=limit)
-    typer.echo(_format_items(results, as_json=_get_json_output()))
-
-
-@app.command()
-def tag(
-    query: Annotated[Optional[str], typer.Argument(
-        help="Tag key to list values, or key=value to find docs"
+    tag: Annotated[Optional[list[str]], typer.Option(
+        "--tag", "-t",
+        help="Filter by tag (key or key=value, repeatable)"
+    )] = None,
+    tags: Annotated[Optional[str], typer.Option(
+        "--tags", "-T",
+        help="List tag keys (--tags=), or values for KEY (--tags=KEY)"
     )] = None,
-    list_keys: Annotated[bool, typer.Option(
-        "--list", "-l",
-        help="List all distinct tag keys"
-    )] = False,
-    store: StoreOption = None,
-    collection: CollectionOption = "default",
-    limit: LimitOption = 100,
     since: SinceOption = None,
 ):
     """
-    List tag values or find items by tag.
+    List recent items, filter by tags, or list tag keys/values.
 
+    \b
     Examples:
-        keep tag --list              # List all tag keys
-        keep tag project             # List values for 'project' tag
-        keep tag project=myapp       # Find docs with project=myapp
+        keep list                      # Recent items
+        keep list --tag foo            # Items with tag 'foo' (any value)
+        keep list --tag foo=bar        # Items with tag foo=bar
+        keep list --tag foo --tag bar  # Items with both tags
+        keep list --tags=              # List all tag keys
+        keep list --tags=foo           # List values for tag 'foo'
+        keep list --since P3D          # Items updated in last 3 days
     """
     kp = _get_keeper(store, collection)
 
-    # List all keys mode
-    if list_keys or query is None:
-        tags = kp.list_tags(None, collection=collection)
-        if _get_json_output():
-            typer.echo(json.dumps(tags))
-        else:
-            if not tags:
-                typer.echo("No tags found.")
-            else:
-                for t in tags:
-                    typer.echo(t)
-        return
-
-    # Check if query is key=value or just key
-    if "=" in query:
-        # key=value → find documents
-        key, value = query.split("=", 1)
-        results = kp.query_tag(key, value, limit=limit, since=since)
-        typer.echo(_format_items(results, as_json=_get_json_output()))
-    else:
-        # key only → list values
-        values = kp.list_tags(query, collection=collection)
+    # --tags mode: list keys or values
+    if tags is not None:
+        # Empty string means list all keys, otherwise list values for key
+        key = tags if tags else None
+        values = kp.list_tags(key, collection=collection)
         if _get_json_output():
             typer.echo(json.dumps(values))
         else:
             if not values:
-                typer.echo(f"No values for tag '{query}'.")
+                if key:
+                    typer.echo(f"No values for tag '{key}'.")
+                else:
+                    typer.echo("No tags found.")
             else:
                 for v in values:
                     typer.echo(v)
+        return
+
+    # --tag mode: filter items by tag(s)
+    if tag:
+        # Parse each tag as key or key=value
+        # Multiple tags require all to match (AND)
+        results = None
+        for t in tag:
+            if "=" in t:
+                key, value = t.split("=", 1)
+                matches = kp.query_tag(key, value, limit=limit, since=since, collection=collection)
+            else:
+                # Key only - find items with this tag key (any value)
+                matches = kp.query_tag(t, limit=limit, since=since, collection=collection)
+
+            if results is None:
+                results = {item.id: item for item in matches}
+            else:
+                # Intersect with previous results
+                match_ids = {item.id for item in matches}
+                results = {id: item for id, item in results.items() if id in match_ids}
+
+        items = list(results.values()) if results else []
+        typer.echo(_format_items(items[:limit], as_json=_get_json_output()))
+        return
+
+    # Default: recent items
+    results = kp.list_recent(limit=limit, since=since, collection=collection)
+    typer.echo(_format_items(results, as_json=_get_json_output()))
 
 
 @app.command("tag-update")
@@ -595,6 +620,7 @@ def tag_update(
 
     Does not re-process the document - only updates tags.
 
+    \b
     Examples:
         keep tag-update doc:1 --tag project=myapp
         keep tag-update doc:1 doc:2 --tag status=reviewed
@@ -657,20 +683,18 @@ def update(
         "--summary",
         help="User-provided summary (skips auto-summarization)"
     )] = None,
-    lazy: Annotated[bool, typer.Option(
-        "--lazy",
-        help="Fast mode: use truncated summary, queue for later processing"
-    )] = False,
 ):
     """
     Add or update a document in the store.
 
+    \b
     Three input modes (auto-detected):
       keep update file:///path       # URI mode: has ://
       keep update "my note"          # Text mode: content-addressed ID
       keep update -                  # Stdin mode: explicit -
       echo "pipe" | keep update      # Stdin mode: piped input
 
+    \b
     Text mode uses content-addressed IDs for versioning:
       keep update "my note"           # Creates _text:{hash}
       keep update "my note" -t done   # Same ID, new version (tag change)
@@ -687,15 +711,15 @@ def update(
         parsed_tags = {**frontmatter_tags, **parsed_tags}  # CLI tags override
         # Use content-addressed ID for stdin text (enables versioning)
         doc_id = id or _text_content_id(content)
-        item = kp.remember(content, id=doc_id, summary=summary, tags=parsed_tags or None, lazy=lazy)
+        item = kp.remember(content, id=doc_id, summary=summary, tags=parsed_tags or None)
     elif source and _URI_SCHEME_PATTERN.match(source):
         # URI mode: fetch from URI (ID is the URI itself)
-        item = kp.update(source, tags=parsed_tags or None, summary=summary, lazy=lazy)
+        item = kp.update(source, tags=parsed_tags or None, summary=summary)
     elif source:
         # Text mode: inline content (no :// in source)
         # Use content-addressed ID for text (enables versioning)
         doc_id = id or _text_content_id(source)
-        item = kp.remember(source, id=doc_id, summary=summary, tags=parsed_tags or None, lazy=lazy)
+        item = kp.remember(source, id=doc_id, summary=summary, tags=parsed_tags or None)
     else:
         typer.echo("Error: Provide content, URI, or '-' for stdin", err=True)
         raise typer.Exit(1)
@@ -732,14 +756,15 @@ def now(
     )] = None,
 ):
     """
-    Get or set the current working context.
+    Get or set the current working intentions.
 
-    With no arguments, displays the current context.
+    With no arguments, displays the current intentions.
     With content, replaces it.
 
+    \b
     Examples:
-        keep now                         # Show current context
-        keep now "What's important now"  # Update context
+        keep now                         # Show current intentions
+        keep now "What's important now"  # Update intentions
         keep now -f context.md           # Read content from file
         keep now --reset                 # Reset to default from system
         keep now -V 1                    # Previous version
@@ -862,7 +887,7 @@ def now(
         item = kp.set_now(new_content, tags=parsed_tags or None)
         typer.echo(_format_item(item, as_json=_get_json_output()))
     else:
-        # Get current context with version navigation and similar items
+        # Get current intentions with version navigation and similar items
         item = kp.get_now()
         version_nav = kp.get_version_nav(NOWDOC_ID, None, collection=collection)
         similar_items = kp.get_similar_for_display(NOWDOC_ID, limit=3, collection=collection)
@@ -907,6 +932,7 @@ def get(
 
     Version identifiers: Append @V{N} to get a specific version.
 
+    \b
     Examples:
         keep get doc:1                  # Current version with similar items
         keep get doc:1 -V 1             # Previous version with prev/next nav

{keep_skill-0.7.0 → keep_skill-0.9.0}/keep/data/system/domains.md

@@ -145,17 +145,17 @@ Ask about scope before large changes." \
 **Temporal queries using system tags:**
 ```bash
 # Find items updated today
-keep tag _updated_date=2026-01-30
+keep list --tag _updated_date=2026-01-30
 
 # Find all inline content (from remember)
-keep tag _source=inline
+keep list --tag _source=inline
 ```
 
 **Progressive refinement:**
 ```bash
 # Start broad, then narrow
 keep find "authentication"
-keep tag module=auth
+keep list --tag module=auth
 ```
 
 ---
@@ -173,7 +173,7 @@ Only then commit to action. Breakdown risk: Promising too early leads to rework.
   --tag type=conversation_pattern --tag domain=general
 
 # Later, retrieve it
-keep tag type=conversation_pattern
+keep list --tag type=conversation_pattern
 ```
 
 See [conversations.md](conversations.md) for the full framework.

{keep_skill-0.7.0 → keep_skill-0.9.0}/keep/data/system/now.md

@@ -5,8 +5,7 @@ tags:
 ---
 # Now
 
-Reminders for essential practice.
-(Keep this updated as you need)
+Now: reflect on this work using `keep`.
 
 **Before acting:**
 - Where are we in the conversation?

{keep_skill-0.7.0 → keep_skill-0.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "keep-skill"
-version = "0.7.0"
+version = "0.9.0"
 description = "Reflective memory - remember and search documents by meaning"
 readme = "README.md"
 requires-python = ">=3.11,<3.14"