ragtime-cli 0.1.0__py3-none-any.whl

ragtime_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,220 @@
+Metadata-Version: 2.4
+Name: ragtime-cli
+Version: 0.1.0
+Summary: Local-first memory and RAG system for Claude Code - semantic search over code, docs, and team knowledge
+Author-email: Bret Martineau <bretwardjames@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/bretwardjames/ragtime
+Project-URL: Repository, https://github.com/bretwardjames/ragtime
+Project-URL: Issues, https://github.com/bretwardjames/ragtime/issues
+Keywords: claude,rag,memory,mcp,ai,llm,semantic-search,vector-database
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+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 :: Documentation
+Classifier: Topic :: Text Processing :: Indexing
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: chromadb>=0.4.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: click>=8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: license-file
+
+# ragtime-cli
+
+Local-first memory and RAG system for Claude Code. Semantic search over code, docs, and team knowledge.
+
+## Features
+
+- **Memory Storage**: Store structured knowledge with namespaces, types, and metadata
+- **Semantic Search**: Query memories and docs with natural language
+- **Cross-Branch Sync**: Share context with teammates before PRs merge
+- **MCP Server**: Native Claude Code integration
+- **Claude Commands**: Pre-built `/remember`, `/recall`, `/handoff`, `/start` commands
+
+## Installation
+
+```bash
+pip install ragtime-cli
+```
+
+## Quick Start
+
+```bash
+# Initialize in your project
+ragtime init
+
+# Store a memory
+ragtime remember "Auth uses JWT with 15-min expiry" \
+  --namespace app \
+  --type architecture \
+  --component auth
+
+# Search memories
+ragtime search "authentication" --namespace app
+
+# Install Claude commands
+ragtime install --workspace
+```
+
+## CLI Commands
+
+### Memory Storage
+
+```bash
+# Store a memory
+ragtime remember "content" --namespace app --type architecture --component auth
+
+# List memories
+ragtime memories --namespace app --type decision
+
+# Graduate branch memory to app
+ragtime graduate <memory-id>
+
+# Delete a memory
+ragtime forget <memory-id>
+```
+
+### Search & Indexing
+
+```bash
+# Index docs
+ragtime index --type docs
+
+# Semantic search
+ragtime search "how does auth work" --namespace app --limit 10
+
+# Reindex memory files
+ragtime reindex
+```
+
+### Cross-Branch Sync
+
+```bash
+# Sync teammate's branch memories
+ragtime sync origin/jm/feature-auth
+
+# Clean up stale synced folders
+ragtime prune --dry-run
+ragtime prune
+```
+
+### Claude Integration
+
+```bash
+# Install Claude commands to workspace
+ragtime install --workspace
+
+# Install globally
+ragtime install --global
+
+# List available commands
+ragtime install --list
+```
+
+## MCP Server
+
+Add to your Claude config (`.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "ragtime": {
+      "command": "ragtime-mcp",
+      "args": ["--path", "."]
+    }
+  }
+}
+```
+
+Available tools:
+- `remember` - Store a memory
+- `search` - Semantic search
+- `list_memories` - List with filters
+- `get_memory` - Get by ID
+- `store_doc` - Store document verbatim
+- `forget` - Delete memory
+- `graduate` - Promote branch → app
+- `update_status` - Change memory status
+
+## Storage Structure
+
+```
+.claude/memory/
+├── app/{component}/            # Graduated app knowledge
+│   └── {id}-{slug}.md
+├── team/                       # Team conventions
+│   └── {id}-{slug}.md
+├── users/{username}/           # User preferences
+│   └── {id}-{slug}.md
+└── branches/
+    ├── {branch-slug}/          # Your branch (tracked in git)
+    │   ├── context.md          # Session handoff
+    │   └── {id}-{slug}.md
+    └── {branch}(unmerged)/     # Synced from teammates (gitignored)
+```
+
+## Memory Format
+
+Memories are markdown files with YAML frontmatter:
+
+```markdown
+---
+id: abc123
+namespace: app
+type: architecture
+component: auth
+confidence: high
+status: active
+added: '2026-01-31'
+author: bretwardjames
+---
+
+Auth uses JWT tokens with 15-minute expiry for security.
+Sessions are stored in Redis, not cookies.
+```
+
+## Namespaces
+
+| Namespace | Purpose |
+|-----------|---------|
+| `app` | How the codebase works (architecture, decisions) |
+| `team` | Team conventions and standards |
+| `user-{name}` | Individual preferences |
+| `branch-{name}` | Work-in-progress context |
+
+## Memory Types
+
+| Type | Description |
+|------|-------------|
+| `architecture` | System design, patterns |
+| `feature` | How features work |
+| `decision` | Why we chose X over Y |
+| `convention` | Team standards |
+| `pattern` | Reusable approaches |
+| `context` | Session handoff |
+
+## Claude Commands
+
+After `ragtime install --workspace`:
+
+| Command | Purpose |
+|---------|---------|
+| `/remember` | Capture knowledge mid-session |
+| `/recall` | Search memories |
+| `/handoff` | Save session context |
+| `/start` | Resume work on an issue |
+| `/pr-graduate` | Curate branch knowledge after merge |
+| `/audit` | Find duplicates/conflicts |
+
+## License
+
+MIT

ragtime_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,21 @@
+ragtime_cli-0.1.0.dist-info/licenses/LICENSE,sha256=9A0wJs2PRDciGRH4F8JUJ-aMKYQyq_gVu2ixrXs-l5A,1070
+src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/cli.py,sha256=7LOyDfHsC-3glutDrasEq8dsLdUPdfWAMauGYfp9tFI,26372
+src/config.py,sha256=_5ev0OkhFKdVaU0T76x-lJUUccn1hB21-dqzV-UleUw,3155
+src/db.py,sha256=BKrlhilXYHNaj-ZcffinSXVhdUqowmwpFPBx7aLxamU,4642
+src/mcp_server.py,sha256=Tx0i73GXO0YmcVrdO7UjRMS0auN8fBG2LOpHuf_LUC0,20374
+src/memory.py,sha256=XZCJMuF1jzmbKGUDZ0K1279x9pF9TXoW6wByw1_VP6w,11961
+src/commands/audit.md,sha256=Xkucm-gfBIMalK9wf7NBbyejpsqBTUAGGlb7GxMtMPY,5137
+src/commands/handoff.md,sha256=8VxTddtW08jGTW36GW_rS77JdeSn8vHeMfklrWwVUD4,5055
+src/commands/pr-graduate.md,sha256=TdqcIwtemrvLbbbUw-mY7hvixjOSh8H_L-63_QsAtpI,6455
+src/commands/recall.md,sha256=unQPWsmocKRoQR7jRtjrj8aVcMHverjGR6u5mYL8TLw,6008
+src/commands/remember.md,sha256=nNewsUhIqF4wtD1jhVDZvmLZjdcmPN6NmUM43SdWepc,5368
+src/commands/save.md,sha256=7gTpW46AU9Y4l8XVZ8f4h1sEdBfVqIRA7hlidUxMAC4,251
+src/commands/start.md,sha256=qoqhkMgET74DBx8YPIT1-wqCiVBUDxlmevigsCinHSY,6506
+src/indexers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/indexers/docs.py,sha256=7FENHaKSvC1T557bRzvmrjyaG_vK94GuQG9XMZdr89w,3349
+ragtime_cli-0.1.0.dist-info/METADATA,sha256=IdKf5KyWm7JabJTCB4344AYbIYTLKKyQc3nYRDIiiM4,5311
+ragtime_cli-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+ragtime_cli-0.1.0.dist-info/entry_points.txt,sha256=cWLbeyMxZNbew-THS3bHXTpCRXt1EaUy5QUOXGXLjl4,75
+ragtime_cli-0.1.0.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+ragtime_cli-0.1.0.dist-info/RECORD,,

ragtime_cli-0.1.0.dist-info/WHEEL

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

ragtime_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+ragtime = src.cli:main
+ragtime-mcp = src.mcp_server:main

ragtime_cli-0.1.0.dist-info/licenses/LICENSE

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

ragtime_cli-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+src