claude_memory 0.1.0

data/skills/analyze/SKILL.md

@@ -0,0 +1,126 @@
+---
+name: project-analysis
+description: Knowledge about analyzing projects for tech stack, frameworks, tools, and conventions. Use when asked to understand or learn about a project's structure.
+user-invocable: false
+---
+
+# Analyze Project Skill
+
+Analyze the current project and store facts about it in long-term memory.
+
+## Workflow
+
+1. **Read key project files** to understand the tech stack
+2. **Extract facts** about languages, frameworks, tools, conventions
+3. **Store facts** using `memory.store_extraction`
+
+## Files to Read
+
+Read these files (if they exist) to understand the project:
+
+### Package/Dependency Files
+- `Gemfile` - Ruby dependencies (Rails, RSpec, etc.)
+- `package.json` - JavaScript/TypeScript dependencies
+- `pyproject.toml` or `requirements.txt` - Python dependencies
+- `Cargo.toml` - Rust dependencies
+- `go.mod` - Go dependencies
+- `pom.xml` or `build.gradle` - Java dependencies
+
+### Configuration Files
+- `README.md` - Project overview and setup instructions
+- `tsconfig.json` - TypeScript configuration
+- `.eslintrc*` or `eslint.config.*` - ESLint configuration
+- `.prettierrc*` - Prettier configuration
+- `.rubocop.yml` or `.standard.yml` - Ruby linting
+- `Dockerfile` - Container configuration
+- `.github/workflows/*.yml` - CI/CD configuration
+
+### Convention Files
+- `.editorconfig` - Editor configuration
+- `CLAUDE.md` or `AGENTS.md` - AI assistant instructions
+
+## What to Extract
+
+Look for and store facts about:
+
+| Category | Predicate | Examples |
+|----------|-----------|----------|
+| Languages | `uses_language` | Ruby, TypeScript, Python, Go, Rust |
+| Frameworks | `uses_framework` | Rails, React, Next.js, Django, FastAPI |
+| Tools | `uses_tool` | RSpec, Jest, ESLint, Prettier, Docker |
+| Databases | `uses_database` | PostgreSQL, MySQL, Redis, MongoDB |
+| Package Manager | `uses_package_manager` | Bundler, npm, pnpm, Poetry, Cargo |
+| CI/CD | `uses_ci` | GitHub Actions, CircleCI, GitLab CI |
+| Conventions | `has_convention` | EditorConfig, 2-space indentation |
+
+## Example Analysis
+
+After reading `Gemfile`:
+```ruby
+source 'https://rubygems.org'
+gem 'rails', '~> 7.0'
+gem 'pg'
+gem 'rspec-rails', group: :test
+```
+
+Store these facts:
+```json
+{
+  "entities": [
+    {"type": "language", "name": "Ruby"},
+    {"type": "framework", "name": "Rails"},
+    {"type": "database", "name": "PostgreSQL"},
+    {"type": "tool", "name": "RSpec"}
+  ],
+  "facts": [
+    {
+      "subject": "repo",
+      "predicate": "uses_language",
+      "object": "Ruby",
+      "quote": "Gemfile present",
+      "strength": "stated"
+    },
+    {
+      "subject": "repo",
+      "predicate": "uses_framework",
+      "object": "Rails",
+      "quote": "gem 'rails', '~> 7.0'",
+      "strength": "stated"
+    },
+    {
+      "subject": "repo",
+      "predicate": "uses_database",
+      "object": "PostgreSQL",
+      "quote": "gem 'pg'",
+      "strength": "stated"
+    },
+    {
+      "subject": "repo",
+      "predicate": "uses_tool",
+      "object": "RSpec",
+      "quote": "gem 'rspec-rails'",
+      "strength": "stated"
+    },
+    {
+      "subject": "repo",
+      "predicate": "uses_package_manager",
+      "object": "Bundler",
+      "quote": "Gemfile present",
+      "strength": "stated"
+    }
+  ]
+}
+```
+
+## Best Practices
+
+1. **Check what exists first**: Use `memory.recall` with broad query like "uses" to see existing facts
+2. **Don't duplicate**: Skip facts that are already stored
+3. **Include quotes**: Reference the specific line or file where you found the information
+4. **Use `stated` strength**: For explicit declarations in config files
+5. **Be selective**: Only store durable, useful facts—not every dependency
+
+## Scope
+
+- Use `scope_hint: "project"` for project-specific facts (default)
+- Use `scope_hint: "global"` for user preferences found in global config files

data/skills/memory/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: memory
+description: Store and recall long-term memory. Use when persisting facts learned during conversations or recalling stored knowledge about projects and preferences.
+---
+
+# Memory Skill
+
+You have access to a long-term memory system. Use it to remember important facts across sessions.
+
+## When to Store Facts
+
+After completing a task or learning something important about the project, store durable facts using `memory.store_extraction`. Look for:
+
+- **Tech stack**: databases, frameworks, languages, platforms
+- **Conventions**: coding standards, naming patterns, preferences
+- **Decisions**: architectural choices, design decisions
+- **Preferences**: user preferences that should persist
+
+## How to Store Facts
+
+Call the `memory.store_extraction` MCP tool with:
+
+```json
+{
+  "entities": [
+    {"type": "database", "name": "postgresql"}
+  ],
+  "facts": [
+    {
+      "subject": "repo",
+      "predicate": "uses_database",
+      "object": "postgresql",
+      "quote": "We use PostgreSQL for persistence",
+      "strength": "stated",
+      "scope_hint": "project"
+    }
+  ]
+}
+```
+
+### Predicates
+
+| Predicate | Use for | Example |
+|-----------|---------|---------|
+| `uses_database` | Database choice | postgresql, redis |
+| `uses_framework` | Framework | rails, react, nextjs |
+| `deployment_platform` | Where deployed | vercel, aws, heroku |
+| `convention` | Coding standard | "4-space indentation" |
+| `decision` | Architectural choice | "Use microservices" |
+| `auth_method` | Auth approach | "JWT tokens" |
+
+### Scope
+
+- `project`: Only this project (default)
+- `global`: All projects (user preferences)
+
+Use `global` when user says "always", "in all projects", or "my preference".
+
+## How to Recall Facts
+
+Use `memory.recall` to search for relevant facts:
+
+```json
+{"query": "database", "limit": 10}
+```
+
+## Available Tools
+
+- `memory.recall` - Search facts by query
+- `memory.store_extraction` - Store new facts
+- `memory.explain` - Get fact details with provenance
+- `memory.promote` - Promote project fact to global
+- `memory.status` - Check database health
+- `memory.changes` - Recent updates
+- `memory.conflicts` - Open contradictions
+
+## Best Practices
+
+1. **Be selective**: Only store durable facts that will be useful later
+2. **Include quotes**: Add the source text for provenance
+3. **Set scope correctly**: Project-specific vs global preferences
+4. **Check before storing**: Use `memory.recall` to avoid duplicates

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification
+name: claude_memory
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Valentino Stoll
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sequel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Turn-key Ruby gem providing Claude Code with instant, high-quality, long-term,
+  self-managed memory using Claude Code Hooks + MCP + Output Style.
+email:
+- v@codenamev.com
+executables:
+- claude-memory
+extensions: []
+extra_rdoc_files: []
+files:
+- ".claude-plugin/marketplace.json"
+- ".claude-plugin/plugin.json"
+- ".claude/CLAUDE.md"
+- ".claude/memory.sqlite3"
+- ".claude/output-styles/memory-aware.md"
+- ".claude/rules/claude_memory.generated.md"
+- ".claude/settings.json"
+- ".claude/settings.local.json"
+- ".mcp.json"
+- CHANGELOG.md
+- CLAUDE.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- commands/analyze.md
+- commands/recall.md
+- commands/remember.md
+- docs/demo.md
+- docs/organizational_memory_playbook.md
+- docs/plan.md
+- docs/plugin.md
+- docs/updated_plan.md
+- exe/claude-memory
+- hooks/hooks.json
+- lib/claude_memory.rb
+- lib/claude_memory/cli.rb
+- lib/claude_memory/distill/distiller.rb
+- lib/claude_memory/distill/extraction.rb
+- lib/claude_memory/distill/json_schema.md
+- lib/claude_memory/distill/null_distiller.rb
+- lib/claude_memory/hook/handler.rb
+- lib/claude_memory/index/lexical_fts.rb
+- lib/claude_memory/ingest/ingester.rb
+- lib/claude_memory/ingest/transcript_reader.rb
+- lib/claude_memory/mcp/server.rb
+- lib/claude_memory/mcp/tools.rb
+- lib/claude_memory/publish.rb
+- lib/claude_memory/recall.rb
+- lib/claude_memory/resolve/predicate_policy.rb
+- lib/claude_memory/resolve/resolver.rb
+- lib/claude_memory/store/sqlite_store.rb
+- lib/claude_memory/store/store_manager.rb
+- lib/claude_memory/sweep/sweeper.rb
+- lib/claude_memory/templates/hooks.example.json
+- lib/claude_memory/templates/output-styles/memory-aware.md
+- lib/claude_memory/version.rb
+- sig/claude_memory.rbs
+- skills/analyze/SKILL.md
+- skills/memory/SKILL.md
+homepage: https://github.com/codenamev/claude_memory
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/codenamev/claude_memory
+  source_code_uri: https://github.com/codenamev/claude_memory
+  changelog_uri: https://github.com/codenamev/claude_memory/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.4
+specification_version: 4
+summary: Long-term, self-managed memory for Claude Code
+test_files: []