rewindex 0.1.0__tar.gz

rewindex-0.1.0/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2026 Rewindex. All rights reserved.
+
+PROPRIETARY SOFTWARE LICENSE
+
+This software and its source code are the exclusive property of Rewindex.
+All rights reserved. No part of this software may be reproduced, distributed,
+modified, sublicensed, or used in any form without the prior written permission
+of Rewindex.
+
+UNAUTHORIZED USE PROHIBITED
+
+This software is provided solely for use by authorized licensees under the
+terms of a separate written agreement with Rewindex. Any use, copying,
+modification, distribution, or disclosure of this software or its contents
+without the express written consent of Rewindex is strictly prohibited and
+may subject the violator to civil and criminal penalties.
+
+THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED. REWINDEX SHALL NOT BE LIABLE FOR ANY DAMAGES ARISING FROM USE OF
+THIS SOFTWARE.

rewindex-0.1.0/PKG-INFO

@@ -0,0 +1,12 @@
+Metadata-Version: 2.4
+Name: rewindex
+Version: 0.1.0
+Summary: Automatic file snapshots for AI-assisted development
+License: Proprietary
+Requires-Python: >=3.10
+Requires-Dist: watchdog<7,>=4.0
+Requires-Dist: questionary<3,>=2.0
+Requires-Dist: click<9,>=8.0
+Requires-Dist: pyyaml<7,>=6.0
+Requires-Dist: psutil<6,>=5.9
+Requires-Dist: rich<15,>=13.0

rewindex-0.1.0/README.md

@@ -0,0 +1,433 @@
+# Rewindex
+
+![version](https://img.shields.io/badge/version-0.1.0-blue)
+![python](https://img.shields.io/badge/python-3.10%2B-blue)
+![license](https://img.shields.io/badge/license-proprietary-red)
+
+**Automatic file snapshots for AI-assisted development.**
+
+Rewindex watches your project files and creates snapshots every time an AI agent (or you) makes a change. Rewind any file to any point in time — no commits needed, no manual saves, no data loss.
+
+Think of it as an **undo history that never forgets**, built specifically for the workflow where AI agents write code on your behalf.
+
+---
+
+## Table of Contents
+
+- [Why Rewindex](#why-rewindex)
+- [How It Works](#how-it-works)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Commands](#commands)
+  - [Snapshot & History](#snapshot--history)
+  - [Rewind & Restore](#rewind--restore)
+  - [Project Management](#project-management)
+  - [Maintenance](#maintenance)
+- [Configuration](#configuration)
+- [Supported AI Agents](#supported-ai-agents)
+- [Session Grouping](#session-grouping)
+- [Snapshot Notes](#snapshot-notes)
+- [Security](#security)
+- [How Snapshots Work](#how-snapshots-work)
+- [FAQ](#faq)
+- [License](#license)
+
+---
+
+## Why Rewindex
+
+When AI agents edit your code, changes happen fast. A single prompt can modify 10 files in seconds. If something goes wrong:
+
+- **Git won't help** — you haven't committed yet
+- **Ctrl+Z won't help** — the AI edited files outside your editor
+- **File backups won't help** — they're too coarse-grained
+
+Rewindex captures every change the moment it happens. You can see exactly what each agent changed, when, and rewind any file to any previous state.
+
+## How It Works
+
+1. A background daemon watches your project folder(s)
+2. When a file changes, Rewindex hashes it and creates a compressed snapshot
+3. Only the delta (diff) is stored — not the entire file
+4. An agent detector identifies which AI tool made the change
+5. You browse history, view diffs, and rewind files through the CLI
+
+Everything stays on your machine. No cloud, no account, no telemetry.
+
+## Installation
+
+> **Supported platforms: macOS and Linux only.** Windows is not yet supported.
+
+```bash
+# pip
+pip install rewindex
+
+# pipx (recommended for CLI tools — keeps dependencies isolated)
+pipx install rewindex
+
+# uv
+uv tool install rewindex
+```
+
+Requires Python 3.10+.
+
+## Quick Start
+
+```bash
+# 1. Set up your first project
+rewindex init
+
+# 2. Start the background daemon
+rewindex start
+
+# 3. Make changes (or let your AI agent work)
+#    Rewindex snapshots automatically in the background
+
+# 4. View what happened
+rewindex log
+
+# 5. See what changed in a specific snapshot
+rewindex diff 42
+
+# 6. Rewind a file to a previous state
+rewindex rewind 42
+
+# 7. Check daemon status
+rewindex status
+```
+
+Non-interactive setup (for AI agents):
+
+```bash
+rewindex init --project my-app --folder ~/projects/my-app
+rewindex start
+```
+
+## Commands
+
+### Snapshot & History
+
+#### `rewindex log`
+
+View snapshot history grouped into sessions.
+
+```bash
+rewindex log                        # session view (default)
+rewindex log --detail               # individual snapshots
+rewindex log --agent claude         # filter by agent
+rewindex log --since "14:00"        # since a specific time
+rewindex log --from 39 --to 44     # index range
+rewindex log --limit 100            # max entries (default: 50)
+```
+
+#### `rewindex diff [INDEX]`
+
+View file changes for a snapshot.
+
+```bash
+rewindex diff                       # interactive — pick from list
+rewindex diff 44                    # show diff for snapshot #44
+```
+
+#### `rewindex snap [LABEL]`
+
+Manually trigger a snapshot of all watched files.
+
+```bash
+rewindex snap                       # snapshot all changed files
+rewindex snap "before refactor"     # with a label
+```
+
+#### `rewindex status`
+
+Show daemon state, project info, snapshot counts, and disk usage.
+
+```bash
+rewindex status
+```
+
+Output:
+```
+Rewindex is running (PID 12345)
+
+  my-app
+    → ~/projects/my-app
+    142 snapshots · 28 files · latest #0142
+    Last activity: 2026-04-15 14:32:05
+    Disk usage: 3.2 MB
+```
+
+### Rewind & Restore
+
+#### `rewindex rewind [INDEX] [FILES...]`
+
+Restore files to a previous snapshot state.
+
+```bash
+# Interactive — pick snapshot and files
+rewindex rewind
+
+# Rewind all files in snapshot #44
+rewindex rewind 44
+
+# Rewind specific file only
+rewindex rewind 44 src/auth.py
+
+# Preview diff without writing (read-only)
+rewindex rewind --preview 44
+
+# Rewind without confirmation (for AI agents)
+rewindex rewind 44 --yes
+
+# Rewind all files changed since snapshot #41
+rewindex rewind --since 41 --yes
+
+# Rewind last change by a specific agent
+rewindex rewind --agent claude --last --yes
+```
+
+#### `rewindex note INDEX TEXT`
+
+Add a note to a snapshot.
+
+```bash
+rewindex note 44 "refactored auth to JWT"
+rewindex note latest "WIP — do not rewind"
+```
+
+### Project Management
+
+#### `rewindex project add NAME FOLDER`
+
+Add a new project to watch.
+
+```bash
+rewindex project add backend ~/api
+```
+
+#### `rewindex project list`
+
+Show all configured projects and their folders.
+
+#### `rewindex project remove NAME`
+
+Stop watching a project. Snapshots are kept on disk.
+
+```bash
+rewindex project remove backend
+rewindex project remove backend --yes   # skip confirmation
+```
+
+To delete snapshot data, run `rewindex cleanup --orphans --apply` after removing.
+
+#### `rewindex project add-folder NAME FOLDER`
+
+Add an additional folder to an existing project.
+
+```bash
+rewindex project add-folder my-app ~/shared-lib
+```
+
+#### `rewindex project remove-folder NAME FOLDER`
+
+Remove a folder from a project.
+
+```bash
+rewindex project remove-folder my-app ~/shared-lib
+```
+
+#### `rewindex project rename OLD NEW`
+
+Rename a project. Updates the config, renames the snapshots directory, and updates all snapshot records in the database.
+
+```bash
+rewindex project rename my-app my-app-v2
+rewindex project rename my-app my-app-v2 --yes   # skip confirmation
+```
+
+### Maintenance
+
+#### `rewindex cleanup`
+
+Identify snapshots that are safe to delete (already committed to git).
+
+```bash
+rewindex cleanup                       # dry run — report only
+rewindex cleanup --apply               # actually delete
+rewindex cleanup --orphans             # show orphaned snapshot dirs
+rewindex cleanup --orphans --apply     # delete orphaned dirs
+```
+
+#### `rewindex update`
+
+Check for updates and sync config.
+
+```bash
+rewindex update                        # check current version
+rewindex update --latest               # upgrade from PyPI
+rewindex update --sync                 # add missing config defaults
+```
+
+#### `rewindex start` / `rewindex stop`
+
+Start or stop the background daemon.
+
+```bash
+rewindex start
+rewindex stop
+```
+
+## Configuration
+
+Config file: `~/.rewindex/.rewindex.config.yaml`
+
+```yaml
+projects:
+  - name: my-app
+    folders:
+      - ~/projects/my-app
+      - ~/projects/shared-lib
+
+exclude:
+  - "node_modules/"
+  - ".git/"
+  - "__pycache__/"
+  - "venv/"
+  - ".venv/"
+  - "*.log"
+  - "*.tmp"
+
+debounce_seconds: 5.0          # wait before snapshotting (group rapid saves)
+session_gap_seconds: 20        # gap threshold for session grouping
+
+history:
+  max_diffs: 600               # auto-trim after this many diffs per file
+  trim_count: 100              # number of oldest diffs removed per trim
+```
+
+### Security Exclusions (hardcoded, not configurable)
+
+These files are **never** snapshotted:
+
+- `.env`, `.env.*`, `*.secret`
+- `id_rsa`, `id_ed25519`, `authorized_keys`
+- `*.pem`, `*.key`, `*.p12`, `*.pfx`
+- `.npmrc`, `.pypirc`, `.netrc`
+- `*.kubeconfig`
+
+## Supported AI Agents
+
+Rewindex auto-detects which AI agent is modifying your files:
+
+| Agent | Detection |
+|-------|-----------|
+| Claude Code | Process name `claude` or node args |
+| Cursor | Process name `cursor` |
+| Windsurf | Process name `windsurf` |
+| Aider | Process name `aider` or python args |
+| Codex (OpenAI) | Process name `codex` or node args |
+| Zed | Process name `zed` |
+| OpenClaw | Process name `openclaw` or node args |
+| OpenCode | Process name `opencode` |
+| Augment Code | Process name `auggie` |
+| Hermes | Process name `hermes` |
+| Goose | Process name `goose` |
+| Plandex | Process name `plandex` or `pdx` |
+| ZeroClaw | Process name `zeroclaw` |
+| Kilo | Process name `kilo` or node args |
+| Pi | Process name `pi` or node args |
+| nanobot | Process name `nanobot` |
+
+If no agent is detected, changes are labeled as `manual`.
+
+## Session Grouping
+
+`rewindex log` groups snapshots into sessions automatically:
+
+- **Same agent + gap ≤ 20 seconds** = same session
+- **Different agent** = always a new session
+
+```
+  #0042–#0044  14:30–14:32  Claude Code       3 files
+           src/auth.py
+           src/middleware.py
+           models/user.py
+
+  #0041        14:15        manual            1 file
+           config.py
+```
+
+Use `rewindex log --detail` to see individual snapshots.
+
+The threshold is configurable via `session_gap_seconds` in your config file.
+
+## Snapshot Notes
+
+Add context to snapshots for future reference:
+
+```bash
+rewindex note latest "refactored auth to use JWT"
+rewindex note 42 "before breaking change"
+```
+
+Notes appear in log output. Designed for both human and AI agent use — agents can annotate their changes automatically.
+
+## Security
+
+- `~/.rewindex/` directory: `chmod 700` (owner only)
+- `daemon.log`: `chmod 600` (owner only)
+- Path traversal protection on all file operations
+- Symlinks that point outside the project folder are ignored
+- SQL injection prevented via parameterized queries throughout
+- LIKE wildcards (`%`, `_`) escaped in agent filters
+- Binary files detected and skipped (null byte check, same method as git)
+- Text files larger than 10 MB are skipped
+- Gzip bomb protection (50 MB decompressed limit)
+- Config file bomb protection (1 MB limit)
+- Log rotation via RotatingFileHandler (5 MB × 3 backups)
+- PID verification before sending stop signal
+- Autostart binary path validated (absolute path, owner check)
+
+## How Snapshots Work
+
+1. **Hash** — SHA-256 hash of the file content
+2. **Compare** — If hash matches the last snapshot, skip (no change)
+3. **Store** — First snapshot is a full copy (`.full.gz`), subsequent ones are diffs (`.diff.gz`)
+4. **Compress** — All snapshots are gzip compressed
+5. **Reconstruct** — To view or rewind, chain: load base → apply diffs in order
+
+Storage is efficient: only deltas are stored, compressed. A typical project uses 1-5 MB for hundreds of snapshots.
+
+### Auto-Trim
+
+When a file accumulates more than `max_diffs` (default: 600) diff snapshots, Rewindex automatically:
+
+1. Promotes the 100th oldest diff to a new full base
+2. Deletes everything before it
+3. History continues seamlessly — no user action needed
+
+Hard safety cap: 1,000 diffs maximum per file in the reconstruction chain.
+
+## FAQ
+
+**Q: Does Rewindex modify my files?**
+A: Never. It only reads files to create snapshots. The only time it writes to your project folder is when you explicitly run `rewindex rewind`.
+
+**Q: Does it send data anywhere?**
+A: No. Everything is stored locally in `~/.rewindex/`. Cloud backup is planned for a future release but is opt-in.
+
+**Q: How much disk space does it use?**
+A: Very little. Diffs are compressed and typically 50-500 bytes each. Run `rewindex status` to check, or `rewindex cleanup` to free space.
+
+**Q: Can I use it without AI agents?**
+A: Yes. Rewindex snapshots any file change, whether made by an AI agent, your editor, or a script. Manual changes are labeled as `manual`.
+
+**Q: What happens if I delete the database?**
+A: The daemon creates a new one on restart and catches up by snapshotting all current files. Previous history is lost, but snapshot files remain on disk.
+
+**Q: Does it work on Windows?**
+A: Not yet. Currently supports Linux and macOS.
+
+## License
+
+Proprietary. See LICENSE for details.

rewindex-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[project]
+name = "rewindex"
+version = "0.1.0"
+description = "Automatic file snapshots for AI-assisted development"
+requires-python = ">=3.10"
+license = { text = "Proprietary" }
+dependencies = [
+    "watchdog>=4.0,<7",
+    "questionary>=2.0,<3",
+    "click>=8.0,<9",
+    "pyyaml>=6.0,<7",
+    "psutil>=5.9,<6",
+    "rich>=13.0,<15",
+]
+
+[project.scripts]
+rewindex = "rewindex.cli:main"
+
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+license-files = []
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["rewindex*"]

rewindex-0.1.0/rewindex/__init__.py

@@ -0,0 +1,4 @@
+# Copyright (c) 2026 Rewindex. All rights reserved.
+# Proprietary and confidential. Unauthorized use prohibited.
+
+__version__ = "0.1.0"

rewindex-0.1.0/rewindex/agent/__init__.py

@@ -0,0 +1,2 @@
+# Copyright (c) 2026 Rewindex. All rights reserved.
+# Proprietary and confidential. Unauthorized use prohibited.

rewindex-0.1.0/rewindex/agent/detector.py

@@ -0,0 +1,40 @@
+# Copyright (c) 2026 Rewindex. All rights reserved.
+# Proprietary and confidential. Unauthorized use prohibited.
+
+import psutil
+
+from .registry import KNOWN_AGENTS
+
+
+def detect_agent() -> str:
+    """
+    Scan running processes and return the display name of the first
+    recognized AI agent found. Returns "manual" if none found.
+    Called once per file-change event — not a continuous poll.
+    """
+    try:
+        for proc in psutil.process_iter(["name", "cmdline"]):
+            name = (proc.info.get("name") or "").lower()
+            cmdline = proc.info.get("cmdline") or []
+            cmdline_str = " ".join(cmdline).lower()
+
+            rule = KNOWN_AGENTS.get(name)
+            if rule is None:
+                continue
+
+            if isinstance(rule, str):
+                return rule
+
+            # dict rule: check args_contains
+            if isinstance(rule, dict):
+                for entry in rule.get("args_contains", []):
+                    if isinstance(entry, str):
+                        if entry in cmdline_str:
+                            return rule["name"]
+                    elif isinstance(entry, dict):
+                        if entry["fragment"] in cmdline_str:
+                            return entry["name"]
+    except (psutil.Error, OSError, AttributeError, TypeError):
+        pass
+
+    return "manual"

rewindex-0.1.0/rewindex/agent/plugins/__init__.py

@@ -0,0 +1,24 @@
+# Copyright (c) 2026 Rewindex. All rights reserved.
+# Proprietary and confidential. Unauthorized use prohibited.
+
+from .aider import AiderPlugin
+from .claude_code import ClaudeCodePlugin
+from .cursor import CursorPlugin
+from .nanobot import NanobotPlugin
+
+_PLUGINS = [
+    AiderPlugin(),
+    ClaudeCodePlugin(),
+    CursorPlugin(),
+    NanobotPlugin(),
+]
+
+# Map agent display name → plugin instance (case-insensitive prefix match)
+_PLUGIN_MAP: dict[str, object] = {p.get_agent_name().lower(): p for p in _PLUGINS}
+
+
+def get_plugin_for_agent(agent: str):
+    """Return plugin instance for the given agent name string, or None."""
+    # agent strings can be "Claude Code", "manual", "manual:label", etc.
+    agent_lower = agent.lower().split(":")[0].strip()
+    return _PLUGIN_MAP.get(agent_lower)

rewindex-0.1.0/rewindex/agent/plugins/aider.py

@@ -0,0 +1,9 @@
+# Copyright (c) 2026 Rewindex. All rights reserved.
+# Proprietary and confidential. Unauthorized use prohibited.
+
+from .base import AgentPlugin
+
+
+class AiderPlugin(AgentPlugin):
+    def get_agent_name(self) -> str:
+        return "Aider"

rewindex-0.1.0/rewindex/agent/plugins/base.py

@@ -0,0 +1,18 @@
+# Copyright (c) 2026 Rewindex. All rights reserved.
+# Proprietary and confidential. Unauthorized use prohibited.
+
+from abc import ABC, abstractmethod
+
+
+class AgentPlugin(ABC):
+    @abstractmethod
+    def get_agent_name(self) -> str:
+        """Return the display name of this agent."""
+        ...
+
+    def on_file_change(self, filepath: str, diff: list) -> None:
+        """
+        Optional hook called after a snapshot is taken.
+        filepath: relative path of the changed file.
+        diff: list of opcodes from snapshot/opcodes.py generate().
+        """

rewindex-0.1.0/rewindex/agent/plugins/claude_code.py

@@ -0,0 +1,9 @@
+# Copyright (c) 2026 Rewindex. All rights reserved.
+# Proprietary and confidential. Unauthorized use prohibited.
+
+from .base import AgentPlugin
+
+
+class ClaudeCodePlugin(AgentPlugin):
+    def get_agent_name(self) -> str:
+        return "Claude Code"

rewindex-0.1.0/rewindex/agent/plugins/cursor.py

@@ -0,0 +1,9 @@
+# Copyright (c) 2026 Rewindex. All rights reserved.
+# Proprietary and confidential. Unauthorized use prohibited.
+
+from .base import AgentPlugin
+
+
+class CursorPlugin(AgentPlugin):
+    def get_agent_name(self) -> str:
+        return "Cursor"

rewindex-0.1.0/rewindex/agent/plugins/nanobot.py

@@ -0,0 +1,9 @@
+# Copyright (c) 2026 Rewindex. All rights reserved.
+# Proprietary and confidential. Unauthorized use prohibited.
+
+from .base import AgentPlugin
+
+
+class NanobotPlugin(AgentPlugin):
+    def get_agent_name(self) -> str:
+        return "nanobot"