vimgym 0.1.1__tar.gz

vimgym-0.1.1/CHANGELOG.md

@@ -0,0 +1,58 @@
+# Changelog
+
+All notable changes to vimgym are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.1] — first official release
+
+### Fixed
+
+- **Duplicate log lines.** The daemon's child process attached both a
+  `FileHandler` and a `StreamHandler(sys.stderr)`, while the parent's
+  `subprocess.Popen` redirected the child's stderr to the same log file.
+  Every record was written twice. The child now uses only a
+  `RotatingFileHandler`; uvicorn's own loggers are forced to propagate
+  through the root logger so we own logging end-to-end.
+- **Wheel installs were missing the bundled redaction rules.** The
+  `defaults/` directory was referenced via a relative path that only
+  worked in editable repo installs. It is now packaged inside
+  `vimgym/defaults/` and loaded via `importlib.resources`, so secrets
+  are correctly stripped under pip, pipx, and Homebrew installs.
+- **Log rotation.** The daemon log now rotates at 5 MB and keeps 5 backups
+  (~25 MB total) instead of growing forever.
+
+### Added
+
+- **`vg doctor`** — comprehensive system diagnostic. Reports vimgym version,
+  Python version, SQLite + FTS5 availability, vault dir & db permissions,
+  daemon state, configured sources, redaction rule count, and free disk
+  space. Exits non-zero on any red issue.
+- **`vg start --no-browser`** — for use as a background service. The
+  Homebrew `brew services` formula uses this so that `launchd` doesn't
+  try to pop a browser.
+- **Virtualenv self-warning.** `vg start` now warns when invoked from
+  a project venv that won't survive a shell restart and points the user
+  at `brew install` or `pipx install`.
+- **Zsh shell completion** (`completions/_vg`), installed automatically
+  by the Homebrew formula.
+- **Makefile and `.envrc`** for one-command developer setup.
+
+### Packaging
+
+- First publish to PyPI.
+- Homebrew tap at [`shoaibrain/homebrew-vimgym`](https://github.com/shoaibrain/homebrew-vimgym).
+- Trusted Publishing (OIDC) for PyPI — no long-lived API tokens in CI.
+- GitHub Actions workflow auto-bumps the tap formula on every published
+  GitHub Release.
+- Cross-platform CI matrix (Linux + macOS, Python 3.11 / 3.12 / 3.13).
+
+### Tests
+
+- Regression test for the duplicate-log-lines bug
+  (`tests/test_daemon.py::test_no_duplicate_log_lines`).
+- New tests for `vg doctor` and CLI flag parsing.
+- Total: 117 tests passing.
+
+[0.1.1]: https://github.com/shoaibrain/vimgym/releases/tag/v0.1.1

vimgym-0.1.1/LICENSE

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

vimgym-0.1.1/MANIFEST.in

@@ -0,0 +1,8 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+include pyproject.toml
+recursive-include src/vimgym/ui *.html *.css *.js
+recursive-include src/vimgym/ui/vendor *.js
+recursive-include src/vimgym/defaults *.json
+recursive-include completions _vg

vimgym-0.1.1/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: vimgym
+Version: 0.1.1
+Summary: AI session memory for developers — local, fast, no cloud
+Author: Shoaib Rain
+License: MIT
+Project-URL: Homepage, https://vimgym.xyz
+Project-URL: Repository, https://github.com/shoaibrain/vimgym
+Project-URL: Issues, https://github.com/shoaibrain/vimgym/issues
+Project-URL: Changelog, https://github.com/shoaibrain/vimgym/blob/main/CHANGELOG.md
+Keywords: claude,claude-code,ai,session,memory,search,developer-tools,local-first
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.110
+Requires-Dist: uvicorn[standard]>=0.29
+Requires-Dist: watchdog>=4.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: rich>=13
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: pytest-timeout>=2.3; extra == "dev"
+Requires-Dist: httpx; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# vimgym
+
+[![PyPI version](https://img.shields.io/pypi/v/vimgym.svg)](https://pypi.org/project/vimgym/)
+[![Python versions](https://img.shields.io/pypi/pyversions/vimgym.svg)](https://pypi.org/project/vimgym/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![CI](https://github.com/shoaibrain/vimgym/actions/workflows/ci.yml/badge.svg)](https://github.com/shoaibrain/vimgym/actions/workflows/ci.yml)
+
+> AI session memory for developers. Local. Fast. No cloud.
+
+Vimgym automatically captures every Claude Code session and makes your entire
+AI conversation history searchable in under 500ms. It's `git log` for your
+AI conversations.
+
+```
+                  ┌──────────────────────────┐
+                  │   ~/.claude/projects/    │
+                  └────────────┬─────────────┘
+                               │ filesystem watcher
+                               ▼
+            ┌─────────────────────────────────┐
+            │  vimgym daemon (single process) │
+            │  parser → redact → SQLite + FTS5│
+            └────────────┬────────────────────┘
+                         │
+                         ▼
+            ┌────────────────────────────────────┐
+            │  http://127.0.0.1:7337             │
+            │  ⌘K  to search · live updates · WS │
+            └────────────────────────────────────┘
+```
+
+## Install
+
+```bash
+# macOS — recommended
+brew tap shoaibrain/vimgym
+brew install vimgym
+
+# Any OS
+pipx install vimgym
+
+# One-liner (auto-detects best method)
+curl -fsSL https://vimgym.xyz/install | sh
+```
+
+After install, run `vg doctor` to verify everything is healthy.
+
+## Quick start
+
+```bash
+vg init     # detect AI tool sources, create vault
+vg start    # spawn daemon, open browser
+```
+
+In the browser, press **⌘K** and start typing. Or from the terminal:
+
+```bash
+vg search "CORS configuration"
+vg search "auth" --project edforge --since 7d
+vg search "rate limiter" --branch dev --json | jq
+```
+
+## Features
+
+- **Automatic capture** — filesystem watcher catches every new session within seconds; zero configuration
+- **Full-text search** — SQLite FTS5 with BM25 ranking, sub-500ms on any vault size, hyphen-safe queries
+- **Three-pane web UI** — Neon Void design, command palette (⌘K), live updates via WebSocket
+- **Session detail** — full conversation rendering with syntax-highlighted code, collapsible tool blocks, copy buttons
+- **Markdown export** — one click to get a paste-friendly transcript for resuming a session in Claude Code
+- **18-pattern redaction** — strips API keys, AWS credentials, kubeconfig certs, SSH keys, JWT tokens, and more *before* anything is written
+- **Source-aware** — auto-detects Claude Code, Cursor, Copilot, Antigravity, Gemini (only Claude Code parser ships in v1)
+- **Local-first** — server binds 127.0.0.1, vault file is `chmod 600`, zero outbound network calls
+
+## CLI
+
+```
+vg start [--no-browser]        Start daemon (watcher + web server), open browser
+vg stop                        Graceful shutdown
+vg status                      Daemon health, vault stats, source list
+vg open                        Open browser if daemon is running
+vg doctor                      Run system diagnostics (Python, FTS5, vault, sources, redaction)
+vg search QUERY [flags]        Terminal search with --project --branch --since --limit --json
+vg init                        Initialize vault, detect AI tool sources
+vg config                      Print active configuration
+vg config sources              List configured sources
+vg config sources ID --enable  Enable a source (takes effect on next vg start)
+vg config sources ID --disable Disable a source
+```
+
+## Documentation
+
+- **[User Guide](docs/GUIDE.md)** — installation, UI walkthrough, search syntax, configuration, troubleshooting
+- **[Developer Reference](docs/DEVELOPER.md)** — architecture, module reference, schema, API, source adapter interface
+
+## Status
+
+v0.1.1 — first official release. 117 tests passing on Python 3.11 / 3.12 / 3.13,
+Linux + macOS. Windows and additional source parsers (Cursor, Copilot, Gemini)
+are v2.
+
+## Requirements
+
+- macOS or Linux
+- Python 3.11+
+- Claude Code
+
+## Contributing
+
+```bash
+git clone https://github.com/shoaibrain/vimgym.git
+cd vimgym
+make install        # creates .venv, installs in editable mode with [dev] extras
+source .venv/bin/activate
+make test           # 117 tests, ~40 seconds
+```
+
+See [docs/DEVELOPER.md](docs/DEVELOPER.md) for the architecture overview.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

vimgym-0.1.1/README.md

@@ -0,0 +1,121 @@
+# vimgym
+
+[![PyPI version](https://img.shields.io/pypi/v/vimgym.svg)](https://pypi.org/project/vimgym/)
+[![Python versions](https://img.shields.io/pypi/pyversions/vimgym.svg)](https://pypi.org/project/vimgym/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![CI](https://github.com/shoaibrain/vimgym/actions/workflows/ci.yml/badge.svg)](https://github.com/shoaibrain/vimgym/actions/workflows/ci.yml)
+
+> AI session memory for developers. Local. Fast. No cloud.
+
+Vimgym automatically captures every Claude Code session and makes your entire
+AI conversation history searchable in under 500ms. It's `git log` for your
+AI conversations.
+
+```
+                  ┌──────────────────────────┐
+                  │   ~/.claude/projects/    │
+                  └────────────┬─────────────┘
+                               │ filesystem watcher
+                               ▼
+            ┌─────────────────────────────────┐
+            │  vimgym daemon (single process) │
+            │  parser → redact → SQLite + FTS5│
+            └────────────┬────────────────────┘
+                         │
+                         ▼
+            ┌────────────────────────────────────┐
+            │  http://127.0.0.1:7337             │
+            │  ⌘K  to search · live updates · WS │
+            └────────────────────────────────────┘
+```
+
+## Install
+
+```bash
+# macOS — recommended
+brew tap shoaibrain/vimgym
+brew install vimgym
+
+# Any OS
+pipx install vimgym
+
+# One-liner (auto-detects best method)
+curl -fsSL https://vimgym.xyz/install | sh
+```
+
+After install, run `vg doctor` to verify everything is healthy.
+
+## Quick start
+
+```bash
+vg init     # detect AI tool sources, create vault
+vg start    # spawn daemon, open browser
+```
+
+In the browser, press **⌘K** and start typing. Or from the terminal:
+
+```bash
+vg search "CORS configuration"
+vg search "auth" --project edforge --since 7d
+vg search "rate limiter" --branch dev --json | jq
+```
+
+## Features
+
+- **Automatic capture** — filesystem watcher catches every new session within seconds; zero configuration
+- **Full-text search** — SQLite FTS5 with BM25 ranking, sub-500ms on any vault size, hyphen-safe queries
+- **Three-pane web UI** — Neon Void design, command palette (⌘K), live updates via WebSocket
+- **Session detail** — full conversation rendering with syntax-highlighted code, collapsible tool blocks, copy buttons
+- **Markdown export** — one click to get a paste-friendly transcript for resuming a session in Claude Code
+- **18-pattern redaction** — strips API keys, AWS credentials, kubeconfig certs, SSH keys, JWT tokens, and more *before* anything is written
+- **Source-aware** — auto-detects Claude Code, Cursor, Copilot, Antigravity, Gemini (only Claude Code parser ships in v1)
+- **Local-first** — server binds 127.0.0.1, vault file is `chmod 600`, zero outbound network calls
+
+## CLI
+
+```
+vg start [--no-browser]        Start daemon (watcher + web server), open browser
+vg stop                        Graceful shutdown
+vg status                      Daemon health, vault stats, source list
+vg open                        Open browser if daemon is running
+vg doctor                      Run system diagnostics (Python, FTS5, vault, sources, redaction)
+vg search QUERY [flags]        Terminal search with --project --branch --since --limit --json
+vg init                        Initialize vault, detect AI tool sources
+vg config                      Print active configuration
+vg config sources              List configured sources
+vg config sources ID --enable  Enable a source (takes effect on next vg start)
+vg config sources ID --disable Disable a source
+```
+
+## Documentation
+
+- **[User Guide](docs/GUIDE.md)** — installation, UI walkthrough, search syntax, configuration, troubleshooting
+- **[Developer Reference](docs/DEVELOPER.md)** — architecture, module reference, schema, API, source adapter interface
+
+## Status
+
+v0.1.1 — first official release. 117 tests passing on Python 3.11 / 3.12 / 3.13,
+Linux + macOS. Windows and additional source parsers (Cursor, Copilot, Gemini)
+are v2.
+
+## Requirements
+
+- macOS or Linux
+- Python 3.11+
+- Claude Code
+
+## Contributing
+
+```bash
+git clone https://github.com/shoaibrain/vimgym.git
+cd vimgym
+make install        # creates .venv, installs in editable mode with [dev] extras
+source .venv/bin/activate
+make test           # 117 tests, ~40 seconds
+```
+
+See [docs/DEVELOPER.md](docs/DEVELOPER.md) for the architecture overview.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

vimgym-0.1.1/completions/_vg

@@ -0,0 +1,57 @@
+#compdef vg
+# zsh completion for vimgym
+
+_vg() {
+  local -a commands
+  commands=(
+    'init:Initialize vault and detect AI tool sources'
+    'start:Start daemon (watcher + web server)'
+    'stop:Stop daemon'
+    'status:Show daemon status and vault stats'
+    'open:Open browser UI'
+    'doctor:Run system diagnostics'
+    'search:Search sessions'
+    'config:View or modify configuration'
+  )
+
+  _arguments -C \
+    '--version[Show version and exit]' \
+    '--verbose[Verbose output]' \
+    '--help[Show help]' \
+    '1: :->command' \
+    '*::arg:->args'
+
+  case $state in
+    command)
+      _describe -t commands 'vg command' commands
+      ;;
+    args)
+      case $words[1] in
+        start)
+          _arguments \
+            '--no-browser[Do not open the browser on start]' \
+            '--help[Show help]'
+          ;;
+        search)
+          _arguments \
+            '--project[Filter by project name]:project' \
+            '--branch[Filter by git branch]:branch' \
+            '--since[Filter by date (ISO or Nd: 7d, 30d)]:since' \
+            '--limit[Maximum results]:limit' \
+            '--json[Output as JSON]' \
+            '--help[Show help]' \
+            '*:query'
+          ;;
+        config)
+          local -a config_subs
+          config_subs=(
+            'sources:List or toggle configured sources'
+          )
+          _describe -t commands 'config subcommand' config_subs
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_vg "$@"

vimgym-0.1.1/defaults/config.json

@@ -0,0 +1,11 @@
+{
+  "vault_dir": "~/.vimgym",
+  "watch_path": "~/.claude/projects",
+  "server_host": "127.0.0.1",
+  "server_port": 7337,
+  "debounce_secs": 5.0,
+  "stability_polls": 2,
+  "stability_poll_interval": 1.0,
+  "auto_open_browser": true,
+  "log_level": "INFO"
+}

vimgym-0.1.1/defaults/redaction-rules.json

@@ -0,0 +1,23 @@
+{
+  "version": 2,
+  "rules": [
+    {"name": "anthropic_key",     "pattern": "sk-ant-[a-zA-Z0-9_\\-]{60,}",                                "replacement": "[REDACTED_ANTHROPIC_KEY]"},
+    {"name": "openai_key",        "pattern": "sk-[a-zA-Z0-9_\\-]{40,}",                                    "replacement": "[REDACTED_OPENAI_KEY]"},
+    {"name": "aws_access",        "pattern": "AKIA[0-9A-Z]{16}",                                           "replacement": "[REDACTED_AWS_KEY]"},
+    {"name": "aws_secret",        "pattern": "(?i)aws.secret.{0,20}[=:]\\s*[a-zA-Z0-9/+]{40}",            "replacement": "[REDACTED_AWS_SECRET]"},
+    {"name": "aws_session_token", "pattern": "AQoXb[a-zA-Z0-9+/]{100,}",                                   "replacement": "[REDACTED_AWS_SESSION]"},
+    {"name": "arn",               "pattern": "arn:aws:[a-z0-9\\-]+:[a-z0-9\\-]*:\\d{12}:[^\\s\"']+",     "replacement": "arn:aws:[REDACTED]"},
+    {"name": "bearer_token",      "pattern": "Bearer\\s+[a-zA-Z0-9._\\-]{20,}",                            "replacement": "Bearer [REDACTED]"},
+    {"name": "github_token",      "pattern": "ghp_[a-zA-Z0-9_]{36,}",                                      "replacement": "[REDACTED_GITHUB_TOKEN]"},
+    {"name": "jwt",               "pattern": "eyJ[a-zA-Z0-9_\\-]+\\.[a-zA-Z0-9_\\-]+\\.[a-zA-Z0-9_\\-]+",  "replacement": "[REDACTED_JWT]"},
+    {"name": "kubeconfig_cert",   "pattern": "certificate-authority-data:\\s*[A-Za-z0-9+/=]{50,}",         "replacement": "certificate-authority-data: [REDACTED]"},
+    {"name": "k8s_token",         "pattern": "(?i)token:\\s*[a-zA-Z0-9._\\-]{40,}",                        "replacement": "token: [REDACTED]"},
+    {"name": "private_key_inline","pattern": "-----BEGIN (EC|RSA|OPENSSH|DSA) PRIVATE KEY-----[\\s\\S]+?-----END \\1 PRIVATE KEY-----", "replacement": "[REDACTED_PRIVATE_KEY]"},
+    {"name": "pem_block",         "pattern": "-----BEGIN [A-Z ]+-----[\\s\\S]+?-----END [A-Z ]+-----",     "replacement": "[REDACTED_PEM_BLOCK]"},
+    {"name": "docker_auth",       "pattern": "\"auth\":\\s*\"[A-Za-z0-9+/=]{20,}\"",                        "replacement": "\"auth\": \"[REDACTED]\""},
+    {"name": "postgres_password", "pattern": "postgresql://[^:/\\s]+:[^@/\\s]+@",                           "replacement": "postgresql://[user]:[REDACTED]@"},
+    {"name": "database_url",      "pattern": "(mongodb|postgres|mysql|redis)://[^\\s]{8,}",                "replacement": "[REDACTED_DB_URL]"},
+    {"name": "npm_token",         "pattern": "//registry\\.npmjs\\.org/:_authToken=[^\\s]+",                "replacement": "//registry.npmjs.org/:_authToken=[REDACTED]"},
+    {"name": "env_secret",        "pattern": "(?i)(password|secret|api_key|private_key)\\s*=\\s*\\S{8,}",   "replacement": "\\1=[REDACTED]"}
+  ]
+}

vimgym-0.1.1/pyproject.toml

@@ -0,0 +1,80 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "vimgym"
+version = "0.1.1"
+description = "AI session memory for developers — local, fast, no cloud"
+readme = "README.md"
+requires-python = ">=3.11"
+license = {text = "MIT"}
+authors = [{name = "Shoaib Rain"}]
+keywords = ["claude", "claude-code", "ai", "session", "memory", "search", "developer-tools", "local-first"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Environment :: Web Environment",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "fastapi>=0.110",
+    "uvicorn[standard]>=0.29",
+    "watchdog>=4.0",
+    "httpx>=0.27",
+    "rich>=13",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio>=0.23",
+    "pytest-timeout>=2.3",
+    "httpx",
+    "ruff",
+    "mypy",
+    "build",
+    "twine",
+]
+
+[project.urls]
+Homepage = "https://vimgym.xyz"
+Repository = "https://github.com/shoaibrain/vimgym"
+Issues = "https://github.com/shoaibrain/vimgym/issues"
+Changelog = "https://github.com/shoaibrain/vimgym/blob/main/CHANGELOG.md"
+
+[project.scripts]
+vg = "vimgym.cli:main"
+
+[tool.setuptools.package-dir]
+"" = "src"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+vimgym = [
+    "ui/index.html",
+    "ui/style.css",
+    "ui/app.js",
+    "ui/vendor/highlight.min.js",
+    "defaults/redaction-rules.json",
+    "defaults/config.json",
+]
+
+[tool.ruff]
+line-length = 100
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

vimgym-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

vimgym-0.1.1/src/vimgym/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.1"