agmem 0.1.1__py3-none-any.whl

agmem-0.1.1.dist-info/RECORD

@@ -0,0 +1,67 @@
+agmem-0.1.1.dist-info/licenses/LICENSE,sha256=X_S6RBErW-F0IDbM3FAEoDB-zxExFnl2m8640rTXphM,1067
+memvcs/__init__.py,sha256=Gs0A8GAivdcePvlse8yWE3t6-vutFO9tWl5dh8lun6I,193
+memvcs/cli.py,sha256=ImQKXb423bHZ2iPr3GndHVojx2KcTuX8rXHwJV1cku0,5364
+memvcs/commands/__init__.py,sha256=lPKiWp-ywEGk1JPK0DeiHSublDwwSD1pU_LyPT-2BhY,510
+memvcs/commands/add.py,sha256=n0J0N_5Mk4uNMtsEt2podLqSKeenaOBRNWMUb9gsq70,8874
+memvcs/commands/base.py,sha256=yWvIYuofRxbHXvChlSd_DL_hJMaQdbZwa2XBDWj5Bio,634
+memvcs/commands/blame.py,sha256=NbaaL3kt9K2zRvYWX6mh-NmXNt5ZOdacSzHDmGY0_Oo,5874
+memvcs/commands/branch.py,sha256=7ocWZVn-WJ1c9pR9Z493ytd_VE6CY6Lakgl5lIzoNeE,3418
+memvcs/commands/checkout.py,sha256=8-fVF9HC5b0dkyO1u0wkGLUwGXrRBc8eSIDD9XBcnjI,3310
+memvcs/commands/clean.py,sha256=SXQqnd31KwmuIFUc2tBVm8ZjZ_3bP2mhbOR9cPBdbIs,2090
+memvcs/commands/clone.py,sha256=YYYURUiW850CHDgctlM4_ysQlPeh35BrS-UG2LSwWZ0,2872
+memvcs/commands/commit.py,sha256=SmeU0MDIMSYQe9PHNZzOLEK1duvflqWdRMrQXkQ6zGM,6380
+memvcs/commands/daemon.py,sha256=nTaWx19MN1IR4u293yna8fuwhHRiYstykSq_3zoUFPc,8385
+memvcs/commands/diff.py,sha256=TxfeqQS84rG2wHRff_WxdwjsNBKRnMkkX4B-7rsVG9Q,5410
+memvcs/commands/fsck.py,sha256=kvJYO0Kr073qZwGtvVqL1c7n7E34QuNzSc-HG3GpWZQ,6890
+memvcs/commands/garden.py,sha256=P8rvC6xYu6q_8VfXEUvtOa2Wez3jHLGGArGeAbn_o4Y,3496
+memvcs/commands/graph.py,sha256=caPyoo-myqmvtg_HEBUGBgQEnNFQXnCIkiNte4zQhqs,4993
+memvcs/commands/init.py,sha256=2TfBniqqJ6PsyHSIgBmkdtpF-kU9UCsc-V4Ct4BSumM,1767
+memvcs/commands/log.py,sha256=tY0Hrn2xkC1SWG_DT2VGbdK-W-oajrM_1r9NVLoEq5k,3141
+memvcs/commands/mcp.py,sha256=PMfwVD6uHltN58Jh7IOiS1w7oND42tg14QKRCJNudmY,1740
+memvcs/commands/merge.py,sha256=qUsJelBynpdv63tL9Oga3t29AnUQCMMJo_CNl3rNvaw,2631
+memvcs/commands/pull.py,sha256=Sk0zfCloyksYbMGCSM9z91pH1gZJ-KLKZasckQhrNd4,2082
+memvcs/commands/push.py,sha256=bCHuxrrBwRNhVDh9GVwhRICtaNLk_a_47EHix4Z66BQ,5081
+memvcs/commands/reflog.py,sha256=AtfJ2dzhsgJVvdQlHU5LUEiAW310QI8yWeUD7GmLoco,1256
+memvcs/commands/remote.py,sha256=sTXf-r6w4OsZgB68ffW9jUtP1xOL8p-kttxvApZNs08,1760
+memvcs/commands/reset.py,sha256=vvHgSb79zVJizWyH-XN6u5jHK2e_gqrNI0JoIUi22es,2991
+memvcs/commands/search.py,sha256=rg-cQfUDl6aNRFa64szpPbqzw508sL9a2u8YtHBhSRM,5324
+memvcs/commands/serve.py,sha256=mhfsULAtU5Gxe43RVo94RRYT1ui4Zmg5Ptatj5rNIUc,1396
+memvcs/commands/show.py,sha256=525-T_na_B3gX6lmFJ05Q4675XNyEd7FFrVl63X2X7Q,3932
+memvcs/commands/stash.py,sha256=aLeeOLUXcFHQYzsYsi9KIg5e_8VFANHMAEvzaqTOgsg,3293
+memvcs/commands/status.py,sha256=P02DFM2-gIf8-dkslzpnj6xNmpxhqmf8bOhHkxA3srw,3647
+memvcs/commands/tag.py,sha256=UCTggFnzHXVMBYjX8usz58duqg4xyOHnIUdVNyoAlWQ,3409
+memvcs/commands/test.py,sha256=xAIzN60U1xL1TieIXOQBsvTRRfZfElVqxEqqHUn72VU,4235
+memvcs/commands/tree.py,sha256=GzA7RYH3bYgSg9QmztYpis6EZWEt6fzwBltoQjaukf4,5059
+memvcs/core/__init__.py,sha256=dkIC-4tS0GhwV2mZIbofEe8xR8uiFwrxslGf1aXwhYg,493
+memvcs/core/config_loader.py,sha256=ebljEMDyVJjQdlpP8if10Whg0I3DfMUBiuAl7S5NVNE,8264
+memvcs/core/constants.py,sha256=WUjAb50BFcF0mbFi_GNteDLCxLihmViBm9Fb-JMPmbM,220
+memvcs/core/diff.py,sha256=wZynRRAF08HyQ_SCcseC0vlmnkoaqoQfQWne3w1o__M,13390
+memvcs/core/gardener.py,sha256=Fr_Zpo_3eZAtA_9zXVT_PpAHfhZkp2-ukLn69FV93rA,16335
+memvcs/core/hooks.py,sha256=3PWqebAt2c6nPw7ZX3epcb5FGLJLrwxh_UMrQeFTyr0,4679
+memvcs/core/knowledge_graph.py,sha256=Ntm4My73Ov3u9YKEgwvDonUVwewx-svCDJD4hGA0hPc,13572
+memvcs/core/merge.py,sha256=i_X-0ye14r62dvlxRWZVkRbIvxd_MtfQSYwuZQEYaCA,17041
+memvcs/core/objects.py,sha256=MvWhQ-L74Rl2lf0rnJE-N3qo78dWGoclJSQinTloNPg,10289
+memvcs/core/pii_scanner.py,sha256=MOycqGTuLJaCNGkaMyMH1ju8gPxQTyLAONoIML7gHKU,11141
+memvcs/core/refs.py,sha256=1-ELwSXWmqdivD_967zb3hw5V3gIiujyn4eRGf8e1u8,16831
+memvcs/core/remote.py,sha256=MhQTfxpzmH0mAMb7hoQJrTOAoqX0tqZxx1Yq5Q5niS8,10117
+memvcs/core/repository.py,sha256=fZ-UUh9EK9nmM8dk9y4TeipkhgGEp5JqDizR6QAEVe4,18119
+memvcs/core/schema.py,sha256=oiStwqD1crbQJf86yJTMI50efd2SaDG3RIPyUxmcxEk,14322
+memvcs/core/staging.py,sha256=EvACqotgi-LKgOdZr6-8Ud1Lkjnflam0KAzpq8eAAp0,7499
+memvcs/core/test_runner.py,sha256=QfEPMjBebM4L4COn9p0XqMcq1Grvij5rOXByUWAcEAg,11823
+memvcs/core/vector_store.py,sha256=Z_C1VZy3Ytv9dfEaqgE6zCb8nNabLaIsDcc1ATstDRI,10546
+memvcs/core/storage/__init__.py,sha256=b2MLjyFgE6L6JAFoyEldxsrR16FGO65qAtxgRj5XFcM,1959
+memvcs/core/storage/base.py,sha256=hHPXuJPR5X1bh7xYAqACHYRfzU4CmPx9trT5tgRghdI,10384
+memvcs/core/storage/gcs.py,sha256=mjcuQHiK6goQ3opRDE6Ky2fSEA9W-MNTOShlGXhY0cM,10953
+memvcs/core/storage/local.py,sha256=CHi3Ot0-u-pCJJOWKW3IP_UIkdz32QAkHcJl1DxatHY,6193
+memvcs/core/storage/s3.py,sha256=rPxZ7avw5KXMSrJrsA2YpM6gVv7Qhn9IQjfoApZIyxE,14230
+memvcs/integrations/__init__.py,sha256=hVtJoFaXt6ErAZwctcSBDZLXRHFs1CNgtltIBQiroQ0,103
+memvcs/integrations/mcp_server.py,sha256=-si5ymayhiRTIfNJwc4EEp4kudav28x8RjzIEDN-n2c,9091
+memvcs/integrations/web_ui/__init__.py,sha256=MQIfgDKDgPctlcTUjwkwueS_MDsDssVRmIUnpECGS0k,51
+memvcs/integrations/web_ui/server.py,sha256=yqokrs6T9l4vAWdRHKMSFLUIkodTJFWihw5Aq_dhGPg,12782
+memvcs/utils/__init__.py,sha256=h74jw3O37su7BFxp52IcZmVReLfd8yDcuk4VzBHbd_s,185
+memvcs/utils/helpers.py,sha256=4k7Jdm-8vCWDASW2kST2vZs-vA9HX8UvqoCwIGsq49g,4273
+agmem-0.1.1.dist-info/METADATA,sha256=8ovwtZcCCNfSeQA6IH5HfAY0MzQgeqxBo1BfRZIkLIU,25844
+agmem-0.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+agmem-0.1.1.dist-info/entry_points.txt,sha256=at7eWycgjqOo1wbUMECnXUsNo3gpCkJTU71OzrGLHu0,42
+agmem-0.1.1.dist-info/top_level.txt,sha256=HtMMsKuwLKLOdgF1GxqQztqFM54tTJctVdJuOec6B-4,7
+agmem-0.1.1.dist-info/RECORD,,

agmem-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

agmem-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agmem = memvcs.cli:main

agmem-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agmem Team
+
+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.

agmem-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+memvcs

memvcs/__init__.py

@@ -0,0 +1,9 @@
+"""
+agmem - Agentic Memory Version Control System
+
+A Git-inspired version control system for AI agent memory artifacts.
+"""
+
+__version__ = "0.1.1"
+__author__ = "agmem Team"
+__license__ = "MIT"

memvcs/cli.py

@@ -0,0 +1,178 @@
+#!/usr/bin/env python3
+"""
+agmem - Agentic Memory Version Control System
+
+A Git-inspired version control system for AI agent memory artifacts.
+
+Usage:
+    agmem init                    Initialize a new repository
+    agmem add <file>              Stage files for commit
+    agmem commit -m "message"     Save staged changes
+    agmem status                  Show working tree status
+    agmem log                     Show commit history
+    agmem branch                  List branches
+    agmem checkout <branch>       Switch branches
+    agmem merge <branch>          Merge branches
+    agmem diff                    Show changes
+"""
+
+import argparse
+import sys
+from typing import List
+
+from .commands.init import InitCommand
+from .commands.add import AddCommand
+from .commands.commit import CommitCommand
+from .commands.status import StatusCommand
+from .commands.log import LogCommand
+from .commands.branch import BranchCommand
+from .commands.checkout import CheckoutCommand
+from .commands.merge import MergeCommand
+from .commands.diff import DiffCommand
+from .commands.show import ShowCommand
+from .commands.reset import ResetCommand
+from .commands.tag import TagCommand
+from .commands.tree import TreeCommand
+from .commands.stash import StashCommand
+from .commands.clean import CleanCommand
+from .commands.blame import BlameCommand
+from .commands.reflog import ReflogCommand
+from .commands.mcp import McpCommand
+from .commands.search import SearchCommand
+from .commands.clone import CloneCommand
+from .commands.push import PushCommand
+from .commands.pull import PullCommand
+from .commands.remote import RemoteCommand
+from .commands.serve import ServeCommand
+from .commands.test import TestCommand
+from .commands.fsck import FsckCommand
+from .commands.graph import GraphCommand
+from .commands.daemon import DaemonCommand
+from .commands.garden import GardenCommand
+
+
+# List of available commands
+COMMANDS = [
+    InitCommand,
+    AddCommand,
+    CommitCommand,
+    StatusCommand,
+    LogCommand,
+    BranchCommand,
+    CheckoutCommand,
+    MergeCommand,
+    DiffCommand,
+    ShowCommand,
+    ResetCommand,
+    TagCommand,
+    TreeCommand,
+    StashCommand,
+    CleanCommand,
+    BlameCommand,
+    ReflogCommand,
+    McpCommand,
+    SearchCommand,
+    CloneCommand,
+    PushCommand,
+    PullCommand,
+    RemoteCommand,
+    ServeCommand,
+    TestCommand,
+    FsckCommand,
+    GraphCommand,
+    DaemonCommand,
+    GardenCommand,
+]
+
+
+def create_parser() -> argparse.ArgumentParser:
+    """Create the main argument parser."""
+    parser = argparse.ArgumentParser(
+        prog='agmem',
+        description='agmem - Agentic Memory Version Control System',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  agmem init                              Initialize a new repository
+  agmem add episodic/session.md           Stage a file
+  agmem add .                             Stage all changes
+  agmem commit -m "Learned user prefs"    Save snapshot
+  agmem status                            Show current status
+  agmem log                               Show commit history
+  agmem branch experiment                 Create a branch
+  agmem checkout experiment               Switch to branch
+  agmem merge experiment                  Merge branch into current
+  agmem diff                              Show unstaged changes
+  agmem diff HEAD~1 HEAD                  Show changes between commits
+  agmem show HEAD                         Show commit details
+  agmem tag v1.0                          Create a tag
+  agmem reset --hard HEAD~1               Reset to previous commit
+  agmem tree                              Show directory tree visually
+
+For more information: https://github.com/vivek-tiwari-vt/agmem
+        """
+    )
+    
+    parser.add_argument(
+        '--version', '-v',
+        action='version',
+        version='%(prog)s 0.1.0'
+    )
+    
+    parser.add_argument(
+        '--verbose',
+        action='store_true',
+        help='Enable verbose output'
+    )
+    
+    # Create subparsers for commands
+    subparsers = parser.add_subparsers(
+        dest='command',
+        help='Available commands',
+        metavar='COMMAND'
+    )
+    
+    # Add each command
+    for cmd_class in COMMANDS:
+        cmd_parser = subparsers.add_parser(
+            cmd_class.name,
+            help=cmd_class.help
+        )
+        cmd_class.add_arguments(cmd_parser)
+    
+    return parser
+
+
+def main(args: List[str] = None) -> int:
+    """Main entry point."""
+    parser = create_parser()
+    parsed_args = parser.parse_args(args)
+    
+    # No command specified
+    if not parsed_args.command:
+        parser.print_help()
+        return 0
+    
+    # Find and execute the command
+    for cmd_class in COMMANDS:
+        if cmd_class.name == parsed_args.command:
+            try:
+                return cmd_class.execute(parsed_args)
+            except KeyboardInterrupt:
+                print("\nOperation cancelled.")
+                return 130
+            except Exception as e:
+                if parsed_args.verbose:
+                    import traceback
+                    traceback.print_exc()
+                else:
+                    print(f"Error: {e}")
+                return 1
+    
+    # Unknown command
+    print(f"Unknown command: {parsed_args.command}")
+    return 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())

memvcs/commands/__init__.py

@@ -0,0 +1,23 @@
+"""agmem CLI commands."""
+
+from .init import InitCommand
+from .add import AddCommand
+from .commit import CommitCommand
+from .status import StatusCommand
+from .log import LogCommand
+from .branch import BranchCommand
+from .checkout import CheckoutCommand
+from .merge import MergeCommand
+from .diff import DiffCommand
+
+__all__ = [
+    'InitCommand',
+    'AddCommand',
+    'CommitCommand',
+    'StatusCommand',
+    'LogCommand',
+    'BranchCommand',
+    'CheckoutCommand',
+    'MergeCommand',
+    'DiffCommand',
+]

memvcs/commands/add.py

@@ -0,0 +1,258 @@
+"""
+agmem add - Add files to the staging area with file type validation.
+"""
+
+import argparse
+from pathlib import Path
+
+from ..commands.base import require_repo
+from ..core.repository import Repository
+
+
+# Default allowed file extensions for memory files
+DEFAULT_ALLOWED_EXTENSIONS = {'.md', '.txt', '.json', '.yaml', '.yml'}
+
+# Binary file signatures (magic bytes) to detect binary files
+BINARY_SIGNATURES = [
+    b'\x89PNG',      # PNG
+    b'\xff\xd8\xff', # JPEG
+    b'GIF8',         # GIF
+    b'%PDF',         # PDF
+    b'PK\x03\x04',   # ZIP
+    b'\x1f\x8b',     # GZIP
+    b'BM',           # BMP
+    b'\x00\x00\x01\x00',  # ICO
+    b'RIFF',         # WAV, AVI, etc.
+]
+
+
+class AddCommand:
+    """Add files to the staging area."""
+    
+    name = 'add'
+    help = 'Add memory files to staging area'
+    
+    @staticmethod
+    def add_arguments(parser: argparse.ArgumentParser):
+        parser.add_argument(
+            'paths',
+            nargs='+',
+            help='Files or directories to stage'
+        )
+        parser.add_argument(
+            '--all', '-A',
+            action='store_true',
+            help='Stage all changes (including modifications and deletions)'
+        )
+        parser.add_argument(
+            '--force', '-f',
+            action='store_true',
+            help='Force add even if file type is not recommended'
+        )
+        parser.add_argument(
+            '--allow-binary',
+            action='store_true',
+            help='Allow staging binary files (not recommended)'
+        )
+    
+    @staticmethod
+    def _is_binary_file(filepath: Path) -> bool:
+        """Check if a file is binary by looking at magic bytes."""
+        try:
+            with open(filepath, 'rb') as f:
+                header = f.read(16)
+            
+            for signature in BINARY_SIGNATURES:
+                if header.startswith(signature):
+                    return True
+            
+            # Also check for null bytes (common in binary files)
+            if b'\x00' in header:
+                return True
+            
+            return False
+        except Exception:
+            return False
+    
+    @staticmethod
+    def _is_allowed_extension(filepath: Path, config: dict) -> bool:
+        """Check if file extension is in allowed list."""
+        allowed = config.get('allowed_extensions', list(DEFAULT_ALLOWED_EXTENSIONS))
+        allowed_set = set(allowed)
+        
+        ext = filepath.suffix.lower()
+        return ext in allowed_set or not ext  # Allow files without extension
+    
+    @staticmethod
+    def _validate_file(filepath: Path, config: dict, force: bool, allow_binary: bool) -> tuple:
+        """
+        Validate a file for staging.
+        
+        Returns:
+            Tuple of (is_valid, warning_message)
+        """
+        # Check for binary files
+        if AddCommand._is_binary_file(filepath):
+            if allow_binary:
+                return True, f"Warning: {filepath} appears to be binary"
+            else:
+                return False, f"Rejected: {filepath} is a binary file. Use --allow-binary to override."
+        
+        # Check extension
+        if not AddCommand._is_allowed_extension(filepath, config):
+            ext = filepath.suffix or '(no extension)'
+            allowed = config.get('allowed_extensions', list(DEFAULT_ALLOWED_EXTENSIONS))
+            
+            if force:
+                return True, f"Warning: {filepath} has extension '{ext}' which may not be optimal"
+            else:
+                return False, (
+                    f"Rejected: {filepath} has extension '{ext}'.\n"
+                    f"  Recommended: {', '.join(sorted(allowed))}\n"
+                    f"  Use --force to override."
+                )
+        
+        return True, None
+    
+    @staticmethod
+    def execute(args) -> int:
+        repo, code = require_repo()
+        if code != 0:
+            return code
+
+        staged_count = 0
+        rejected_count = 0
+        config = repo.get_config()
+        
+        for path_str in args.paths:
+            path = Path(path_str)
+            
+            # Handle '.' to stage all
+            if path_str == '.':
+                staged, rejected = AddCommand._stage_directory_with_validation(
+                    repo, None, config, args.force, args.allow_binary
+                )
+                staged_count += staged
+                rejected_count += rejected
+                continue
+            
+            # Resolve path relative to current/
+            if path.is_absolute():
+                try:
+                    rel_path = path.relative_to(repo.current_dir)
+                except ValueError:
+                    print(f"Error: Path {path} is outside repository")
+                    continue
+            else:
+                # Check if it's in current/ or needs to be resolved
+                if (repo.current_dir / path).exists():
+                    rel_path = path
+                elif path.exists():
+                    # Path exists outside current/, copy it in
+                    target = repo.current_dir / path.name
+                    if path.is_file():
+                        target.write_bytes(path.read_bytes())
+                    rel_path = Path(path.name)
+                else:
+                    print(f"Error: Path not found: {path}")
+                    continue
+            
+            full_path = repo.current_dir / rel_path
+            
+            if not full_path.exists():
+                print(f"Error: Path not found: {path}")
+                continue
+            
+            if full_path.is_file():
+                # Validate file
+                is_valid, message = AddCommand._validate_file(
+                    full_path, config, args.force, args.allow_binary
+                )
+                
+                if not is_valid:
+                    print(message)
+                    rejected_count += 1
+                    continue
+                
+                if message:  # Warning
+                    print(message)
+                
+                try:
+                    blob_hash = repo.stage_file(str(rel_path))
+                    print(f"  staged: {rel_path}")
+                    staged_count += 1
+                except Exception as e:
+                    print(f"Error staging {rel_path}: {e}")
+            
+            elif full_path.is_dir():
+                staged, rejected = AddCommand._stage_directory_with_validation(
+                    repo, str(rel_path), config, args.force, args.allow_binary
+                )
+                staged_count += staged
+                rejected_count += rejected
+        
+        if staged_count > 0 or rejected_count > 0:
+            print(f"\nStaged {staged_count} file(s)")
+            if rejected_count > 0:
+                print(f"Rejected {rejected_count} file(s) - use --force to override")
+            if staged_count > 0:
+                print("Run 'agmem commit -m \"message\"' to save snapshot")
+        else:
+            print("No files staged")
+        
+        return 0
+    
+    @staticmethod
+    def _stage_directory_with_validation(repo, subdir: str, config: dict, force: bool, allow_binary: bool) -> tuple:
+        """
+        Stage a directory with file validation.
+        
+        Returns:
+            Tuple of (staged_count, rejected_count)
+        """
+        staged_count = 0
+        rejected_count = 0
+        
+        if subdir:
+            dir_path = repo.current_dir / subdir
+        else:
+            dir_path = repo.current_dir
+        
+        if not dir_path.exists():
+            return 0, 0
+        
+        for file_path in dir_path.rglob('*'):
+            if not file_path.is_file():
+                continue
+            
+            # Skip hidden files and .mem directory
+            rel_to_current = file_path.relative_to(repo.current_dir)
+            if any(part.startswith('.') for part in rel_to_current.parts):
+                continue
+            
+            # Validate file
+            is_valid, message = AddCommand._validate_file(
+                file_path, config, force, allow_binary
+            )
+            
+            if not is_valid:
+                if not force:
+                    # Only print first few rejections to avoid spam
+                    if rejected_count < 5:
+                        print(f"  {message}")
+                    elif rejected_count == 5:
+                        print("  ... (more files rejected)")
+                rejected_count += 1
+                continue
+            
+            if message:  # Warning
+                print(message)
+            
+            try:
+                repo.stage_file(str(rel_to_current))
+                print(f"  staged: {rel_to_current}")
+                staged_count += 1
+            except Exception as e:
+                print(f"Error staging {rel_to_current}: {e}")
+        
+        return staged_count, rejected_count

memvcs/commands/base.py

@@ -0,0 +1,23 @@
+"""
+Base command - shared logic for agmem commands.
+"""
+
+from pathlib import Path
+from typing import Optional, Tuple
+
+from memvcs.core.repository import Repository
+
+
+def require_repo(repo_path: Optional[Path] = None) -> Tuple[Optional[Repository], int]:
+    """
+    Resolve repository and validate it exists.
+
+    Returns:
+        Tuple of (Repository or None, exit_code). If invalid, returns (None, 1).
+    """
+    path = (repo_path or Path(".")).resolve()
+    repo = Repository(path)
+    if not repo.is_valid_repo():
+        print("Error: Not an agmem repository. Run 'agmem init' first.")
+        return None, 1
+    return repo, 0