omni-cortex 1.0.1__tar.gz

omni_cortex-1.0.1/.gitignore

@@ -0,0 +1,157 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Project specific
+.omni-cortex/
+*.db
+*.db-journal
+*.db-wal
+*.db-shm
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test files
+test_*.py
+!tests/test_*.py
+
+# Development files
+PROMPT.md
+memories.json
+.claude/
+.mcp.json

omni_cortex-1.0.1/LICENSE

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

omni_cortex-1.0.1/PKG-INFO

@@ -0,0 +1,216 @@
+Metadata-Version: 2.4
+Name: omni-cortex
+Version: 1.0.1
+Summary: Universal Memory MCP for Claude Code - dual-layer activity logging and knowledge storage
+Project-URL: Homepage, https://github.com/AllCytes/Omni-Cortex
+Project-URL: Repository, https://github.com/AllCytes/Omni-Cortex
+Project-URL: Issues, https://github.com/AllCytes/Omni-Cortex/issues
+Project-URL: Documentation, https://github.com/AllCytes/Omni-Cortex#readme
+Author: Tony
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,anthropic,claude,claude-code,llm,mcp,memory,semantic-search
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pyyaml>=6.0.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: semantic
+Requires-Dist: numpy>=1.24.0; extra == 'semantic'
+Requires-Dist: sentence-transformers>=2.2.0; extra == 'semantic'
+Description-Content-Type: text/markdown
+
+# Omni Cortex MCP
+
+A universal memory system for Claude Code that combines activity logging with intelligent knowledge storage.
+
+## Features
+
+- **Zero Configuration**: Works out of the box - just install and run setup
+- **Dual-Layer Storage**: Activity logging (audit trail) + Knowledge store (memories)
+- **15 MCP Tools**: Full-featured API for memory management, activity tracking, and session continuity
+- **Semantic Search**: AI-powered search using sentence-transformers (optional)
+- **Hybrid Search**: Combines keyword (FTS5) + semantic search for best results
+- **Full-Text Search**: SQLite FTS5-powered keyword search with smart ranking
+- **Auto-Categorization**: Automatic memory type detection and tag suggestions
+- **Session Continuity**: "Last time you were working on..." context
+- **Importance Decay**: Frequently accessed memories naturally surface
+- **Auto Activity Logging**: Automatically logs all tool calls via hooks
+
+## Installation
+
+### Quick Install (Recommended)
+
+```bash
+# Install the package
+pip install omni-cortex
+
+# Run automatic setup (configures MCP server + hooks)
+omni-cortex-setup
+```
+
+That's it! Omni Cortex will now:
+- Automatically log all Claude Code tool calls
+- Provide memory tools (cortex_remember, cortex_recall, etc.)
+- Create a per-project database at `.omni-cortex/cortex.db`
+
+### With Semantic Search
+
+For AI-powered semantic search capabilities:
+
+```bash
+pip install omni-cortex[semantic]
+omni-cortex-setup
+```
+
+### From Source
+
+```bash
+git clone https://github.com/AllCytes/Omni-Cortex.git
+cd omni-cortex
+pip install -e ".[semantic]"
+python -m omni_cortex.setup
+```
+
+### Manual Configuration
+
+If you prefer manual setup, add to `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "omni-cortex": {
+      "command": "python",
+      "args": ["-m", "omni_cortex.server"]
+    }
+  }
+}
+```
+
+And optionally configure hooks in `~/.claude/settings.json` for activity logging:
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [{
+      "type": "command",
+      "command": "python -m omni_cortex.hooks.pre_tool_use"
+    }],
+    "PostToolUse": [{
+      "type": "command",
+      "command": "python -m omni_cortex.hooks.post_tool_use"
+    }]
+  }
+}
+```
+
+### Uninstall
+
+```bash
+omni-cortex-setup --uninstall
+pip uninstall omni-cortex
+```
+
+## Tools
+
+### Memory Tools (6)
+
+| Tool | Description |
+|------|-------------|
+| `cortex_remember` | Store information with auto-categorization |
+| `cortex_recall` | Search memories (modes: keyword, semantic, hybrid) |
+| `cortex_list_memories` | List memories with filters and pagination |
+| `cortex_update_memory` | Update memory content, tags, or status |
+| `cortex_forget` | Delete a memory |
+| `cortex_link_memories` | Create relationships between memories |
+
+### Activity Tools (3)
+
+| Tool | Description |
+|------|-------------|
+| `cortex_log_activity` | Manually log an activity |
+| `cortex_get_activities` | Query the activity log |
+| `cortex_get_timeline` | Get a chronological timeline |
+
+### Session Tools (3)
+
+| Tool | Description |
+|------|-------------|
+| `cortex_start_session` | Start a new session with context |
+| `cortex_end_session` | End session and generate summary |
+| `cortex_get_session_context` | Get context from previous sessions |
+
+### Utility Tools (3)
+
+| Tool | Description |
+|------|-------------|
+| `cortex_list_tags` | List all tags with usage counts |
+| `cortex_review_memories` | Review and update memory freshness |
+| `cortex_export` | Export data to markdown or JSON |
+
+## Memory Types
+
+Memories are automatically categorized into:
+
+- `general` - General notes and information
+- `warning` - Cautions, things to avoid
+- `tip` - Tips, tricks, best practices
+- `config` - Configuration and settings
+- `troubleshooting` - Debugging and problem-solving
+- `code` - Code snippets and algorithms
+- `error` - Error messages and failures
+- `solution` - Solutions to problems
+- `command` - CLI commands
+- `concept` - Definitions and explanations
+- `decision` - Architectural decisions
+
+## Storage
+
+- **Per-project**: `.omni-cortex/cortex.db` in your project directory
+- **Global**: `~/.omni-cortex/global.db` for cross-project search
+
+## Configuration
+
+Create `.omni-cortex/config.yaml` in your project:
+
+```yaml
+schema_version: "1.0"
+embedding_enabled: true
+decay_rate_per_day: 0.5
+freshness_review_days: 30
+auto_provide_context: true
+context_depth: 3
+```
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Format code
+black src tests
+ruff check src tests
+```
+
+## License
+
+MIT

omni_cortex-1.0.1/README.md

@@ -0,0 +1,179 @@
+# Omni Cortex MCP
+
+A universal memory system for Claude Code that combines activity logging with intelligent knowledge storage.
+
+## Features
+
+- **Zero Configuration**: Works out of the box - just install and run setup
+- **Dual-Layer Storage**: Activity logging (audit trail) + Knowledge store (memories)
+- **15 MCP Tools**: Full-featured API for memory management, activity tracking, and session continuity
+- **Semantic Search**: AI-powered search using sentence-transformers (optional)
+- **Hybrid Search**: Combines keyword (FTS5) + semantic search for best results
+- **Full-Text Search**: SQLite FTS5-powered keyword search with smart ranking
+- **Auto-Categorization**: Automatic memory type detection and tag suggestions
+- **Session Continuity**: "Last time you were working on..." context
+- **Importance Decay**: Frequently accessed memories naturally surface
+- **Auto Activity Logging**: Automatically logs all tool calls via hooks
+
+## Installation
+
+### Quick Install (Recommended)
+
+```bash
+# Install the package
+pip install omni-cortex
+
+# Run automatic setup (configures MCP server + hooks)
+omni-cortex-setup
+```
+
+That's it! Omni Cortex will now:
+- Automatically log all Claude Code tool calls
+- Provide memory tools (cortex_remember, cortex_recall, etc.)
+- Create a per-project database at `.omni-cortex/cortex.db`
+
+### With Semantic Search
+
+For AI-powered semantic search capabilities:
+
+```bash
+pip install omni-cortex[semantic]
+omni-cortex-setup
+```
+
+### From Source
+
+```bash
+git clone https://github.com/AllCytes/Omni-Cortex.git
+cd omni-cortex
+pip install -e ".[semantic]"
+python -m omni_cortex.setup
+```
+
+### Manual Configuration
+
+If you prefer manual setup, add to `~/.claude.json`:
+
+```json
+{
+  "mcpServers": {
+    "omni-cortex": {
+      "command": "python",
+      "args": ["-m", "omni_cortex.server"]
+    }
+  }
+}
+```
+
+And optionally configure hooks in `~/.claude/settings.json` for activity logging:
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [{
+      "type": "command",
+      "command": "python -m omni_cortex.hooks.pre_tool_use"
+    }],
+    "PostToolUse": [{
+      "type": "command",
+      "command": "python -m omni_cortex.hooks.post_tool_use"
+    }]
+  }
+}
+```
+
+### Uninstall
+
+```bash
+omni-cortex-setup --uninstall
+pip uninstall omni-cortex
+```
+
+## Tools
+
+### Memory Tools (6)
+
+| Tool | Description |
+|------|-------------|
+| `cortex_remember` | Store information with auto-categorization |
+| `cortex_recall` | Search memories (modes: keyword, semantic, hybrid) |
+| `cortex_list_memories` | List memories with filters and pagination |
+| `cortex_update_memory` | Update memory content, tags, or status |
+| `cortex_forget` | Delete a memory |
+| `cortex_link_memories` | Create relationships between memories |
+
+### Activity Tools (3)
+
+| Tool | Description |
+|------|-------------|
+| `cortex_log_activity` | Manually log an activity |
+| `cortex_get_activities` | Query the activity log |
+| `cortex_get_timeline` | Get a chronological timeline |
+
+### Session Tools (3)
+
+| Tool | Description |
+|------|-------------|
+| `cortex_start_session` | Start a new session with context |
+| `cortex_end_session` | End session and generate summary |
+| `cortex_get_session_context` | Get context from previous sessions |
+
+### Utility Tools (3)
+
+| Tool | Description |
+|------|-------------|
+| `cortex_list_tags` | List all tags with usage counts |
+| `cortex_review_memories` | Review and update memory freshness |
+| `cortex_export` | Export data to markdown or JSON |
+
+## Memory Types
+
+Memories are automatically categorized into:
+
+- `general` - General notes and information
+- `warning` - Cautions, things to avoid
+- `tip` - Tips, tricks, best practices
+- `config` - Configuration and settings
+- `troubleshooting` - Debugging and problem-solving
+- `code` - Code snippets and algorithms
+- `error` - Error messages and failures
+- `solution` - Solutions to problems
+- `command` - CLI commands
+- `concept` - Definitions and explanations
+- `decision` - Architectural decisions
+
+## Storage
+
+- **Per-project**: `.omni-cortex/cortex.db` in your project directory
+- **Global**: `~/.omni-cortex/global.db` for cross-project search
+
+## Configuration
+
+Create `.omni-cortex/config.yaml` in your project:
+
+```yaml
+schema_version: "1.0"
+embedding_enabled: true
+decay_rate_per_day: 0.5
+freshness_review_days: 30
+auto_provide_context: true
+context_depth: 3
+```
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Format code
+black src tests
+ruff check src tests
+```
+
+## License
+
+MIT