ragtime-cli 0.2.17__tar.gz → 0.3.0__tar.gz

{ragtime_cli-0.2.17/ragtime_cli.egg-info → ragtime_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ragtime-cli
-Version: 0.2.17
+Version: 0.3.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
@@ -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
 
@@ -54,9 +58,15 @@ pip install ragtime-cli
 ## Quick Start
 
 ```bash
-# Initialize in your project
+# Initialize in your project (prompts to set up MCP server)
 ragtime init
 
+# Or skip prompts with -y
+ragtime -y init
+
+# Or just enable MCP globally (works in any project)
+ragtime init -G
+
 # Index your docs
 ragtime index
 
@@ -69,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
@@ -196,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
@@ -249,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
@@ -398,25 +412,60 @@ Sessions are stored in Redis, not cookies.
 | `integration` | External service connections |
 | `context` | Session handoff |
 
-## Claude Commands
+## AI Integration
 
-After `ragtime install --workspace`:
+Ragtime is designed to work seamlessly with AI agents via MCP tools. Run `ragtime usage` for comprehensive documentation on integration patterns.
 
-| 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 |
+### 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
 
-Add to your Claude config (`.mcp.json`):
+The MCP server is automatically configured during `ragtime init`. You can also set it up manually:
+
+```bash
+# Project-level: creates .mcp.json in current project
+ragtime init
+
+# Global: adds to ~/.claude/settings.json (works in any project)
+ragtime init -G
+```
+
+Or add manually to `.mcp.json`:
 
 ```json
 {
@@ -429,6 +478,8 @@ Add to your Claude config (`.mcp.json`):
 }
 ```
 
+The MCP server automatically finds the project root (`.ragtime` directory) even when Claude is started from a subdirectory.
+
 Available tools:
 - `remember` - Store a memory
 - `search` - Semantic search (supports tiered mode and auto-extraction)

{ragtime_cli-0.2.17 → ragtime_cli-0.3.0}/README.md

@@ -2,6 +2,10 @@
 
 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
@@ -12,8 +16,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
 
@@ -24,9 +28,15 @@ pip install ragtime-cli
 ## Quick Start
 
 ```bash
-# Initialize in your project
+# Initialize in your project (prompts to set up MCP server)
 ragtime init
 
+# Or skip prompts with -y
+ragtime -y init
+
+# Or just enable MCP globally (works in any project)
+ragtime init -G
+
 # Index your docs
 ragtime index
 
@@ -39,8 +49,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
@@ -166,17 +176,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
@@ -219,6 +229,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
@@ -368,25 +382,60 @@ Sessions are stored in Redis, not cookies.
 | `integration` | External service connections |
 | `context` | Session handoff |
 
-## Claude Commands
+## AI Integration
 
-After `ragtime install --workspace`:
+Ragtime is designed to work seamlessly with AI agents via MCP tools. Run `ragtime usage` for comprehensive documentation on integration patterns.
 
-| 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 |
+### 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
 
-Add to your Claude config (`.mcp.json`):
+The MCP server is automatically configured during `ragtime init`. You can also set it up manually:
+
+```bash
+# Project-level: creates .mcp.json in current project
+ragtime init
+
+# Global: adds to ~/.claude/settings.json (works in any project)
+ragtime init -G
+```
+
+Or add manually to `.mcp.json`:
 
 ```json
 {
@@ -399,6 +448,8 @@ Add to your Claude config (`.mcp.json`):
 }
 ```
 
+The MCP server automatically finds the project root (`.ragtime` directory) even when Claude is started from a subdirectory.
+
 Available tools:
 - `remember` - Store a memory
 - `search` - Semantic search (supports tiered mode and auto-extraction)

{ragtime_cli-0.2.17 → ragtime_cli-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ragtime-cli"
-version = "0.2.17"
+version = "0.3.0"
 description = "Local-first memory and RAG system for Claude Code - semantic search over code, docs, and team knowledge"
 readme = "README.md"
 license = "MIT"
@@ -49,8 +49,5 @@ build-backend = "setuptools.build_meta"
 where = ["."]
 include = ["src*"]
 
-[tool.setuptools.package-data]
-"src.commands" = ["*.md"]
-
 [tool.ruff]
 line-length = 100

{ragtime_cli-0.2.17 → ragtime_cli-0.3.0/ragtime_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ragtime-cli
-Version: 0.2.17
+Version: 0.3.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
@@ -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
 
@@ -54,9 +58,15 @@ pip install ragtime-cli
 ## Quick Start
 
 ```bash
-# Initialize in your project
+# Initialize in your project (prompts to set up MCP server)
 ragtime init
 
+# Or skip prompts with -y
+ragtime -y init
+
+# Or just enable MCP globally (works in any project)
+ragtime init -G
+
 # Index your docs
 ragtime index
 
@@ -69,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
@@ -196,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
@@ -249,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
@@ -398,25 +412,60 @@ Sessions are stored in Redis, not cookies.
 | `integration` | External service connections |
 | `context` | Session handoff |
 
-## Claude Commands
+## AI Integration
 
-After `ragtime install --workspace`:
+Ragtime is designed to work seamlessly with AI agents via MCP tools. Run `ragtime usage` for comprehensive documentation on integration patterns.
 
-| 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 |
+### 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
 
-Add to your Claude config (`.mcp.json`):
+The MCP server is automatically configured during `ragtime init`. You can also set it up manually:
+
+```bash
+# Project-level: creates .mcp.json in current project
+ragtime init
+
+# Global: adds to ~/.claude/settings.json (works in any project)
+ragtime init -G
+```
+
+Or add manually to `.mcp.json`:
 
 ```json
 {
@@ -429,6 +478,8 @@ Add to your Claude config (`.mcp.json`):
 }
 ```
 
+The MCP server automatically finds the project root (`.ragtime` directory) even when Claude is started from a subdirectory.
+
 Available tools:
 - `remember` - Store a memory
 - `search` - Semantic search (supports tiered mode and auto-extraction)

{ragtime_cli-0.2.17 → ragtime_cli-0.3.0}/ragtime_cli.egg-info/SOURCES.txt

@@ -14,16 +14,6 @@ src/db.py
 src/feedback.py
 src/mcp_server.py
 src/memory.py
-src/commands/audit.md
-src/commands/create-pr.md
-src/commands/generate-docs.md
-src/commands/handoff.md
-src/commands/import-docs.md
-src/commands/pr-graduate.md
-src/commands/recall.md
-src/commands/remember.md
-src/commands/save.md
-src/commands/start.md
 src/indexers/__init__.py
 src/indexers/code.py
 src/indexers/docs.py