ragtime-cli 0.2.18__py3-none-any.whl → 0.3.1__py3-none-any.whl

{ragtime_cli-0.2.18.dist-info → ragtime_cli-0.3.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ragtime-cli
-Version: 0.2.18
+Version: 0.3.1
 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
@@ -32,6 +32,10 @@ Dynamic: license-file
 
 Local-first memory and RAG system for Claude Code. Semantic search over code, docs, and team knowledge.
 
+**Two interfaces, same data:**
+- **CLI** for humans - formatted output, interactive workflows
+- **MCP** for agents - structured data, tool integration
+
 ## Features
 
 - **Memory Storage**: Store structured knowledge with namespaces, types, and metadata
@@ -42,8 +46,8 @@ Local-first memory and RAG system for Claude Code. Semantic search over code, do
 - **Doc Generation**: Generate documentation from code (stubs or AI-powered)
 - **Debug Tools**: Verify index integrity, inspect similarity scores
 - **MCP Server**: Native Claude Code integration
-- **Claude Commands**: Pre-built `/remember`, `/recall`, `/create-pr`, `/generate-docs` commands
-- **ghp-cli Integration**: Auto-context when starting issues
+- **Usage Documentation**: Guidance for integrating ragtime into AI workflows
+- **ghp-cli Integration**: Auto-context when starting issues via hooks
 
 ## Installation
 
@@ -75,8 +79,8 @@ ragtime remember "Auth uses JWT with 15-min expiry" \
 # Search memories
 ragtime search "authentication" --namespace app
 
-# Install Claude commands
-ragtime install --workspace
+# View usage documentation for AI integration
+ragtime usage
 
 # Check for updates
 ragtime update --check
@@ -202,17 +206,17 @@ ragtime daemon status
 ragtime daemon stop
 ```
 
-### Claude Integration
+### Usage Documentation
 
 ```bash
-# Install Claude commands to workspace
-ragtime install --workspace
-
-# Install globally
-ragtime install --global
+# View all usage documentation
+ragtime usage
 
-# List available commands
-ragtime install --list
+# View specific sections
+ragtime usage --section mcp        # MCP server integration
+ragtime usage --section cli        # CLI workflow examples
+ragtime usage --section workflows  # Common AI workflow patterns
+ragtime usage --section conventions # Convention checking
 
 # Set up ghp-cli hooks
 ragtime setup-ghp
@@ -255,6 +259,10 @@ code:
 conventions:
   files: [".ragtime/CONVENTIONS.md"]
   also_search_memories: true
+  storage: auto  # auto | file | memory | ask
+  default_file: ".ragtime/CONVENTIONS.md"
+  folder: ".ragtime/conventions/"
+  scan_docs_for_sections: ["docs/"]
 ```
 
 ## How Search Works
@@ -404,21 +412,46 @@ Sessions are stored in Redis, not cookies.
 | `integration` | External service connections |
 | `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 |
-| `/create-pr` | Check conventions, graduate memories, create PR |
-| `/generate-docs` | AI-powered documentation generation from code |
-| `/import-docs` | Migrate existing docs to memories |
-| `/pr-graduate` | Curate branch knowledge (fallback if forgot before PR) |
-| `/audit` | Find duplicates/conflicts in memories |
+## AI Integration
+
+Ragtime is designed to work seamlessly with AI agents via MCP tools. Run `ragtime usage` for comprehensive documentation on integration patterns.
+
+### Key Patterns
+
+**Memory Storage**: Use `remember` to capture architectural decisions, patterns, and context:
+```
+remember("Auth uses JWT with 15-min expiry", namespace="app", type="architecture", component="auth")
+```
+
+**Semantic Search**: Use `search` for finding relevant code and documentation:
+```
+search("how does authentication work", tiered=True)  # Prioritizes curated knowledge
+search("error handling", require_terms=["mobile", "dart"])  # Hybrid filtering
+```
+
+**Convention Checking**: Before PRs, verify code follows team standards:
+```bash
+ragtime check-conventions          # Filtered to changed files
+ragtime check-conventions --all    # All conventions (for AI analysis)
+```
+
+**Handoff Context**: Save session state for continuity:
+```
+store_doc(content="Session summary...", namespace="branch-feature-123", doc_type="handoff")
+```
+
+### Building Custom Commands
+
+Create project-specific slash commands in `.claude/commands/` that orchestrate ragtime tools:
+
+```markdown
+# .claude/commands/my-workflow.md
+1. Search for relevant context: search("$ARGUMENTS", tiered=True)
+2. Store any new insights: remember(...)
+3. Check conventions before suggesting changes
+```
+
+The **real value is in the MCP tools** - combine them however fits your workflow.
 
 ## MCP Server
 

ragtime_cli-0.3.1.dist-info/RECORD

@@ -0,0 +1,16 @@
+ragtime_cli-0.3.1.dist-info/licenses/LICENSE,sha256=9A0wJs2PRDciGRH4F8JUJ-aMKYQyq_gVu2ixrXs-l5A,1070
+src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+src/cli.py,sha256=AhapSVnIw9xnd-wXQ0vF533Gt-CNoec7H07Ph6fS2TE,111238
+src/config.py,sha256=_pKQIjkPSquU7ClrTf8Eev_ZagtSV-KWbzHAwSaRe3A,5590
+src/db.py,sha256=eWqFGrg3O6hve67EzRJGcAsIpYxWJo4JlrAtlZUUA_s,15169
+src/feedback.py,sha256=cPw_lzusZZPvkgUxs_eV67NtV1FoCfTXUulBPnD78lo,6455
+src/mcp_server.py,sha256=ttXBtWPur6D4FWaJyJf80YaYlkF6Ak6tADNB4tD5N7E,27205
+src/memory.py,sha256=UiHyudKbseMMY-sdcaDSfVBMGj6sFXXw1GxBsZ7nuBc,18450
+src/indexers/__init__.py,sha256=MYoCPZUpHakMX1s2vWnc9shjWfx_X1_0JzUhpKhnKUQ,454
+src/indexers/code.py,sha256=G2TbiKbWj0e7DV5KsU8-Ggw6ziDb4zTuZ4Bu3ryV4g8,18059
+src/indexers/docs.py,sha256=IyCKjgglVIqkufqlrRLfGb605pTdRYj8-tISxJXGJqI,13344
+ragtime_cli-0.3.1.dist-info/METADATA,sha256=zZjoqZVwOGZz6NTa2rocsmfnX2xkYF0lhhR4aQwhwb8,14662
+ragtime_cli-0.3.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+ragtime_cli-0.3.1.dist-info/entry_points.txt,sha256=cWLbeyMxZNbew-THS3bHXTpCRXt1EaUy5QUOXGXLjl4,75
+ragtime_cli-0.3.1.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+ragtime_cli-0.3.1.dist-info/RECORD,,