one-ctx 0.1.0__tar.gz

one_ctx-0.1.0/.gitignore

@@ -0,0 +1,35 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Database
+*.db
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Test artifacts
+test_mcp.py
+
+# Debug files
+mcp_debug.log
+claude_debug.log
+run_ctx_debug.bat
+run_claude_debug.bat

one_ctx-0.1.0/LICENSE

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

one_ctx-0.1.0/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: one-ctx
+Version: 0.1.0
+Summary: Combined Context — One MCP server. Every AI tool. No re-explaining.
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: click>=8.1.0
+Requires-Dist: mcp[cli]>=1.0.0
+Requires-Dist: sse-starlette>=2.0.0
+Requires-Dist: uvicorn[standard]>=0.29.0
+Provides-Extra: llm
+Requires-Dist: anthropic>=0.40.0; extra == 'llm'
+Description-Content-Type: text/markdown
+
+# one-context — Combined Context
+
+> One MCP server. Every AI tool. No re-explaining.
+
+![Architecture Diagram](assets/architecture.png)
+
+Claude Code, Cline, Antigravity, Codex, Ollama — they all point to the same place.  
+You explain your project once. Every tool knows it forever.
+
+**No API keys needed. No cloud. No accounts. 100% local.**
+
+## The Architecture
+
+Every AI tool keeps its own internal memory. That doesn't change. But they all **read and write to one shared root**:
+
+```mermaid
+graph TD
+    %% Define styles
+    classDef rootNode fill:#0d1117,stroke:#58a6ff,stroke-width:3px,color:#c9d1d9,font-size:16px,font-weight:bold;
+    classDef aiNode fill:#161b22,stroke:#3fb950,stroke-width:2px,color:#c9d1d9,font-size:14px;
+    classDef bucketNode fill:#21262d,stroke:#8b949e,stroke-dasharray: 5 5,color:#c9d1d9;
+
+    %% Nodes
+    A([one-context MCP]):::rootNode
+    
+    C1[Claude Code]:::aiNode
+    C2[Cline]:::aiNode
+    C3[Antigravity]:::aiNode
+    C4[Codex]:::aiNode
+    
+    B1[(WHAT\nProject Scope)]:::bucketNode
+    B2[(DONE\nHistory)]:::bucketNode
+    B3[(NOW\nCurrent Task)]:::bucketNode
+    B4[(MAP\nKey Files)]:::bucketNode
+
+    %% Connections
+    C1 <-->|reads/writes| A
+    C2 <-->|reads/writes| A
+    C3 <-->|reads/writes| A
+    C4 <-->|reads/writes| A
+    
+    A --- B1
+    A --- B2
+    A --- B3
+    A --- B4
+```
+
+## Install
+
+With `uv` installed, you don't even need to download this repository. Your AI tools will fetch it automatically from PyPI!
+
+## Connect Your AI Tools
+
+### Option A: Command/stdio (recommended)
+
+Works with Claude Desktop, Cline, Codex, and any MCP client. Just add this to your MCP settings file:
+
+```json
+{
+  "mcpServers": {
+    "one-context": {
+      "command": "uvx",
+      "args": ["one-context", "stdio"]
+    }
+  }
+}
+```
+
+No server to start. The AI tool launches it automatically.
+
+### Option B: HTTP/SSE (for network setups)
+
+```bash
+uvx one-context serve
+```
+
+Then point any MCP client to `http://localhost:7337/sse`.
+
+## The Four Buckets
+
+| Bucket | Contains | Updated when... |
+|--------|----------|----------------|
+| **WHAT** | Project description, stack, architecture, constraints | Project-level info changes |
+| **DONE** | Decisions made, files changed, problems solved | Any tool finishes a task |
+| **NOW** | Current task, current state, what's in progress | A new task starts |
+| **MAP** | Important file paths and what they do | AI discovers key files |
+
+## Usage in any tool
+
+Start a session:
+```
+"Load context from one-context for my-project"
+```
+
+Finish a session:
+```
+"Update one-context with what we just did"
+```
+
+Register important files:
+```
+"Use ctx_map to register src/main.py as the entry point"
+```
+
+Search across all your projects:
+```
+"Search one-context for 'SQLite lock error'"
+```
+
+## MCP Tools (6 total)
+
+| Tool | Description |
+|------|-------------|
+| `ctx_get(project)` | Get the full WHAT/DONE/NOW/MAP snapshot + git info |
+| `ctx_update(project, session_summary, tool_name)` | Merge a session update into context |
+| `ctx_map(project, files)` | Register important files manually |
+| `ctx_search(query)` | Search across ALL projects' context and history |
+| `ctx_reset(project)` | Wipe project context to empty |
+| `ctx_list()` | List all tracked projects |
+
+Projects are auto-created on first `ctx_update` — you don't need `ctx init`.
+
+## Advanced Features
+
+### MAP — Important Files
+When an AI tool discovers that `src/main.py` is the entry point, it saves those paths to the MAP bucket. The next AI tool instantly knows which files matter without scanning the entire codebase.
+
+### Git Branch Awareness
+Link a project to its git repo:
+```bash
+ctx init my-project --path /path/to/repo
+```
+Now `ctx_get` automatically includes the current branch name, last 5 commits, and uncommitted changes.
+
+### Cross-Project Search
+```bash
+ctx search "SQLite"
+```
+Searches across ALL projects' context (what/done/now/map) and update history. Find how you solved a problem before.
+
+## Summarization Modes
+
+| Mode | Setup | API Key? |
+|------|-------|----------|
+| **Local** (default) | Nothing | No |
+| **Ollama** | `CTX_OLLAMA_MODEL=llama3.2` | No |
+| **Claude** | `ANTHROPIC_API_KEY=...` | Yes |
+| **OpenAI / Groq / Together** | `OPENAI_API_KEY=...` | Yes |
+
+Priority: Ollama > Claude > OpenAI > Local fallback. If any provider fails, it silently falls back. **Local always works.**
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `ctx stdio` | Run via stdio (for MCP clients) |
+| `ctx serve` | Start HTTP/SSE server |
+| `ctx init <project> [--path /repo]` | Initialize with optional git repo |
+| `ctx status [project]` | Show context + git info |
+| `ctx search <query>` | Search across all projects |
+| `ctx reset <project>` | Reset project context |
+| `ctx list` | List all projects |
+| `ctx delete <project>` | Delete a project |
+
+## License
+
+MIT

one_ctx-0.1.0/README.md

@@ -0,0 +1,167 @@
+# one-context — Combined Context
+
+> One MCP server. Every AI tool. No re-explaining.
+
+![Architecture Diagram](assets/architecture.png)
+
+Claude Code, Cline, Antigravity, Codex, Ollama — they all point to the same place.  
+You explain your project once. Every tool knows it forever.
+
+**No API keys needed. No cloud. No accounts. 100% local.**
+
+## The Architecture
+
+Every AI tool keeps its own internal memory. That doesn't change. But they all **read and write to one shared root**:
+
+```mermaid
+graph TD
+    %% Define styles
+    classDef rootNode fill:#0d1117,stroke:#58a6ff,stroke-width:3px,color:#c9d1d9,font-size:16px,font-weight:bold;
+    classDef aiNode fill:#161b22,stroke:#3fb950,stroke-width:2px,color:#c9d1d9,font-size:14px;
+    classDef bucketNode fill:#21262d,stroke:#8b949e,stroke-dasharray: 5 5,color:#c9d1d9;
+
+    %% Nodes
+    A([one-context MCP]):::rootNode
+    
+    C1[Claude Code]:::aiNode
+    C2[Cline]:::aiNode
+    C3[Antigravity]:::aiNode
+    C4[Codex]:::aiNode
+    
+    B1[(WHAT\nProject Scope)]:::bucketNode
+    B2[(DONE\nHistory)]:::bucketNode
+    B3[(NOW\nCurrent Task)]:::bucketNode
+    B4[(MAP\nKey Files)]:::bucketNode
+
+    %% Connections
+    C1 <-->|reads/writes| A
+    C2 <-->|reads/writes| A
+    C3 <-->|reads/writes| A
+    C4 <-->|reads/writes| A
+    
+    A --- B1
+    A --- B2
+    A --- B3
+    A --- B4
+```
+
+## Install
+
+With `uv` installed, you don't even need to download this repository. Your AI tools will fetch it automatically from PyPI!
+
+## Connect Your AI Tools
+
+### Option A: Command/stdio (recommended)
+
+Works with Claude Desktop, Cline, Codex, and any MCP client. Just add this to your MCP settings file:
+
+```json
+{
+  "mcpServers": {
+    "one-context": {
+      "command": "uvx",
+      "args": ["one-context", "stdio"]
+    }
+  }
+}
+```
+
+No server to start. The AI tool launches it automatically.
+
+### Option B: HTTP/SSE (for network setups)
+
+```bash
+uvx one-context serve
+```
+
+Then point any MCP client to `http://localhost:7337/sse`.
+
+## The Four Buckets
+
+| Bucket | Contains | Updated when... |
+|--------|----------|----------------|
+| **WHAT** | Project description, stack, architecture, constraints | Project-level info changes |
+| **DONE** | Decisions made, files changed, problems solved | Any tool finishes a task |
+| **NOW** | Current task, current state, what's in progress | A new task starts |
+| **MAP** | Important file paths and what they do | AI discovers key files |
+
+## Usage in any tool
+
+Start a session:
+```
+"Load context from one-context for my-project"
+```
+
+Finish a session:
+```
+"Update one-context with what we just did"
+```
+
+Register important files:
+```
+"Use ctx_map to register src/main.py as the entry point"
+```
+
+Search across all your projects:
+```
+"Search one-context for 'SQLite lock error'"
+```
+
+## MCP Tools (6 total)
+
+| Tool | Description |
+|------|-------------|
+| `ctx_get(project)` | Get the full WHAT/DONE/NOW/MAP snapshot + git info |
+| `ctx_update(project, session_summary, tool_name)` | Merge a session update into context |
+| `ctx_map(project, files)` | Register important files manually |
+| `ctx_search(query)` | Search across ALL projects' context and history |
+| `ctx_reset(project)` | Wipe project context to empty |
+| `ctx_list()` | List all tracked projects |
+
+Projects are auto-created on first `ctx_update` — you don't need `ctx init`.
+
+## Advanced Features
+
+### MAP — Important Files
+When an AI tool discovers that `src/main.py` is the entry point, it saves those paths to the MAP bucket. The next AI tool instantly knows which files matter without scanning the entire codebase.
+
+### Git Branch Awareness
+Link a project to its git repo:
+```bash
+ctx init my-project --path /path/to/repo
+```
+Now `ctx_get` automatically includes the current branch name, last 5 commits, and uncommitted changes.
+
+### Cross-Project Search
+```bash
+ctx search "SQLite"
+```
+Searches across ALL projects' context (what/done/now/map) and update history. Find how you solved a problem before.
+
+## Summarization Modes
+
+| Mode | Setup | API Key? |
+|------|-------|----------|
+| **Local** (default) | Nothing | No |
+| **Ollama** | `CTX_OLLAMA_MODEL=llama3.2` | No |
+| **Claude** | `ANTHROPIC_API_KEY=...` | Yes |
+| **OpenAI / Groq / Together** | `OPENAI_API_KEY=...` | Yes |
+
+Priority: Ollama > Claude > OpenAI > Local fallback. If any provider fails, it silently falls back. **Local always works.**
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `ctx stdio` | Run via stdio (for MCP clients) |
+| `ctx serve` | Start HTTP/SSE server |
+| `ctx init <project> [--path /repo]` | Initialize with optional git repo |
+| `ctx status [project]` | Show context + git info |
+| `ctx search <query>` | Search across all projects |
+| `ctx reset <project>` | Reset project context |
+| `ctx list` | List all projects |
+| `ctx delete <project>` | Delete a project |
+
+## License
+
+MIT

one_ctx-0.1.0/_check_names.py

@@ -0,0 +1,10 @@
+import urllib.request
+from urllib.error import HTTPError
+
+names = ['one-ctx', 'octx-mcp', 'ctx-mcp', 'onectx', 'mcp-ctx']
+for n in names:
+    try:
+        urllib.request.urlopen(f'https://pypi.org/pypi/{n}/json')
+        print(f'{n}: TAKEN')
+    except HTTPError:
+        print(f'{n}: AVAILABLE')

one_ctx-0.1.0/ctx/__init__.py

@@ -0,0 +1 @@
+"""ctx — Combined Context MCP Server."""

one_ctx-0.1.0/ctx/cli.py

@@ -0,0 +1,159 @@
+import sys
+if sys.platform == 'win32':
+    import asyncio
+    asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
+import sys
+import anyio
+import click
+from ctx.database import (
+    init_project, get_project, reset_project, list_projects,
+    search_projects, search_logs,
+)
+from ctx.server import mcp_server
+from ctx.git import get_git_summary
+import mcp.server.stdio
+
+@click.group()
+def cli():
+    """ctx -- Combined Context MCP Server."""
+    pass
+
+@cli.command()
+@click.option("--port", default=7337, help="Port to run the server on")
+@click.option("--host", default="0.0.0.0", help="Host to bind to")
+def serve(port, host):
+    """Start the HTTP/SSE server."""
+    import uvicorn
+    print(f"[ctx] server starting on http://{host}:{port}")
+    print(f"   SSE endpoint:     http://localhost:{port}/sse")
+    print(f"   Messages endpoint: http://localhost:{port}/messages/")
+    print(f"   Health check:      http://localhost:{port}/health\n")
+    print("Add to your MCP config:")
+    print(f'   {{"mcpServers": {{"ctx": {{"url": "http://localhost:{port}/sse"}}}}}}\n')
+    
+    uvicorn.run("ctx.server:app", host=host, port=port, log_level="info")
+
+@cli.command()
+def stdio():
+    """Start the stdio server (for direct VS Code / Cline / Codex integration)."""
+    async def run():
+        async with mcp.server.stdio.stdio_server() as (read_stream, write_stream):
+            await mcp_server.run(
+                read_stream,
+                write_stream,
+                mcp_server.create_initialization_options()
+            )
+    anyio.run(run)
+
+@cli.command()
+@click.argument("project")
+@click.option("--path", default="", help="Path to the project's git repo on disk")
+def init(project, path):
+    """Initialize a new project context."""
+    result = init_project(project, repo_path=path)
+    if "error" in result:
+        print(f"[!] {result['error']}")
+        return
+    print(f"[OK] Project '{project}' initialized.")
+    if path:
+        print(f"   Git repo linked: {path}")
+    print("   Start any AI tool and call ctx_get to load context.")
+
+@cli.command()
+@click.argument("project", required=False)
+def status(project):
+    """View the context for a project, or list all projects."""
+    if not project:
+        projects = list_projects()
+        if not projects:
+            print("No projects found.")
+            return
+        print("=== Tracked Projects ===")
+        for p in projects:
+            print(f"- {p['project']} (last updated: {p['updated_at']})")
+        return
+
+    data = get_project(project)
+    if "error" in data:
+        print(f"Error: {data['error']}")
+        return
+
+    print(f"=== {project} ===")
+    print(f"\n[WHAT]\n{data.get('what', '(empty)') or '(empty)'}")
+    print(f"\n[DONE]\n{data.get('done', '(empty)') or '(empty)'}")
+    print(f"\n[NOW]\n{data.get('now', '(empty)') or '(empty)'}")
+    print(f"\n[MAP]\n{data.get('map', '(empty)') or '(no files mapped)'}")
+
+    # Show git info if repo_path is set
+    repo_path = data.get("repo_path", "")
+    if repo_path:
+        print(f"\n[GIT] repo: {repo_path}")
+        git_info = get_git_summary(repo_path)
+        if git_info:
+            print(f"   Branch: {git_info['branch']}")
+            if git_info.get("recent_commits"):
+                print(f"   Recent commits:")
+                for c in git_info["recent_commits"][:3]:
+                    print(f"     {c['hash']} {c['message']}")
+            changed = git_info.get("changed_files", {})
+            total_changes = len(changed.get("staged", [])) + len(changed.get("unstaged", [])) + len(changed.get("untracked", []))
+            if total_changes:
+                print(f"   Changed files: {total_changes}")
+        else:
+            print("   (git not available or not a repo)")
+
+@cli.command()
+@click.argument("project")
+def reset(project):
+    """Reset a project's context back to empty."""
+    reset_project(project)
+    print(f"[OK] Project '{project}' has been reset to empty.")
+
+@cli.command(name="list")
+def list_cmd():
+    """List all tracked projects."""
+    projects = list_projects()
+    if not projects:
+        print("No projects found.")
+        return
+    print("=== Tracked Projects ===")
+    for p in projects:
+        print(f"- {p['project']} (last updated: {p['updated_at']})")
+
+@cli.command()
+@click.argument("project")
+def delete(project):
+    """Permanently delete a project."""
+    from ctx.database import delete_project
+    result = delete_project(project)
+    if "error" in result:
+        print(f"[!] {result['error']}")
+    else:
+        print(f"[OK] Project '{project}' deleted.")
+
+@cli.command()
+@click.argument("query")
+def search(query):
+    """Search across all projects' context and history."""
+    project_matches = search_projects(query)
+    log_matches = search_logs(query)
+
+    if not project_matches and not log_matches:
+        print(f"No results found for '{query}'.")
+        return
+
+    if project_matches:
+        print(f"=== Projects matching '{query}' ===")
+        for m in project_matches:
+            buckets = ", ".join(m["matched_buckets"])
+            print(f"- {m['project']} (found in: {buckets})")
+
+    if log_matches:
+        print(f"\n=== History matching '{query}' ===")
+        for m in log_matches:
+            print(f"- [{m['project']}] [{m['tool_name']} @ {m['timestamp'][:16]}] {m['summary'][:100]}")
+
+    print(f"\nTotal: {len(project_matches)} projects, {len(log_matches)} history entries")
+
+if __name__ == "__main__":
+    cli()