gobby 0.2.5__tar.gz → 0.2.7__tar.gz

{gobby-0.2.5 → gobby-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gobby
-Version: 0.2.5
+Version: 0.2.7
 Summary: A local-first daemon to unify your AI coding tools. Session tracking and handoffs across Claude Code, Gemini CLI, and Codex. An MCP proxy that discovers tools without flooding context. Task management with dependencies, validation, and TDD expansion. Agent spawning and worktree orchestration. Persistent memory, extensible workflows, and hooks.
 Author-email: Josh Wilhelmi <josh@gobby.ai>
 License-Expression: MIT
@@ -38,8 +38,10 @@ Requires-Dist: msgspec>=0.20.0
 Requires-Dist: gitingest>=0.3.1
 Requires-Dist: scikit-learn>=1.0.0
 Requires-Dist: textual>=7.3.0
-Requires-Dist: mem0ai
 Requires-Dist: memu-py>=1.0.0
+Requires-Dist: python-multipart>=0.0.22
+Provides-Extra: mem0
+Requires-Dist: mem0ai; extra == "mem0"
 Dynamic: license-file
 
 <!-- markdownlint-disable MD033 MD041 -->
@@ -149,35 +151,92 @@ call_tool("gobby-worktrees", "spawn_agent_in_worktree", {
 })
 ```
 
-## Quick Start
+### 🔗 Claude Code Task Integration
+
+Gobby transparently intercepts Claude Code's built-in task system (TaskCreate, TaskUpdate, etc.) and syncs operations to Gobby's persistent task store. Benefits:
+
+- **Tasks persist** across sessions (unlike CC's session-scoped tasks)
+- **Commit linking** — tasks auto-link to git commits
+- **Validation gates** — define criteria for task completion
+- **LLM expansion** — break complex tasks into subtasks
+
+No configuration needed — just use Claude Code's native task tools and Gobby handles the rest.
+
+### 📚 Skills System
+
+Reusable instructions that teach agents how to perform specific tasks. Compatible with the [Agent Skills specification](https://agentskills.io) and SkillPort.
+
+- **Core skills** bundled with Gobby for tasks, sessions, memory, workflows
+- **Project skills** in `.gobby/skills/` for team-specific patterns
+- **Install from anywhere** — GitHub repos, local paths, ZIP archives
+- **Search and discovery** — TF-IDF and semantic search across your skill library
+
+```bash
+# Install a skill from GitHub
+gobby skills install github:user/repo/skills/my-skill
+
+# Search for relevant skills
+gobby skills search "testing coverage"
+```
+
+## Installation
+
+### Try it instantly
+```bash
+uvx gobby --help
+```
 
+### Install globally
 ```bash
-# Clone and install
-git clone https://github.com/GobbyAI/gobby.git
-cd gobby
-uv sync
+# With uv (recommended)
+uv tool install gobby
 
+# With pipx
+pipx install gobby
+
+# With pip
+pip install gobby
+```
+
+**Requirements:** Python 3.13+
+
+## Quick Start
+
+```bash
 # Start the daemon
-uv run gobby start
+gobby start
 
 # In your project directory
-uv run gobby init
-uv run gobby install  # Installs hooks for detected CLIs
-
-# Optional: install globally
-uv pip install -e .
+gobby init
+gobby install  # Installs hooks for detected CLIs
 ```
 
-**Requirements:** Python 3.11+, [uv](https://github.com/astral-sh/uv), at least one AI CLI ([Claude Code](https://claude.ai/code), [Gemini CLI](https://github.com/google-gemini/gemini-cli), or [Codex CLI](https://github.com/openai/codex))
+**Requirements:** At least one AI CLI ([Claude Code](https://claude.ai/code), [Gemini CLI](https://github.com/google-gemini/gemini-cli), or [Codex CLI](https://github.com/openai/codex))
 
 Works with your Claude, Gemini, or Codex subscriptions—or bring your own API keys. Local model support coming soon.
 
 ## Configure Your AI CLI
 
-Add Gobby as an MCP server:
+Add Gobby as an MCP server. Choose the `command` and `args` that match your installation:
+
+- **pip/pipx install**: `"command": "gobby"`, `"args": ["mcp-server"]`
+- **uv tool install**: `"command": "uv"`, `"args": ["run", "gobby", "mcp-server"]`
 
 **Claude Code** (`.mcp.json` or `~/.claude.json`):
 
+```json
+{
+  "mcpServers": {
+    "gobby": {
+      "command": "gobby",
+      "args": ["mcp-server"]
+    }
+  }
+}
+```
+
+Or with uv:
+
 ```json
 {
   "mcpServers": {
@@ -195,8 +254,8 @@ Add Gobby as an MCP server:
 {
   "mcpServers": {
     "gobby": {
-      "command": "uv",
-      "args": ["run", "gobby", "mcp-server"]
+      "command": "gobby",
+      "args": ["mcp-server"]
     }
   }
 }
@@ -206,8 +265,8 @@ Add Gobby as an MCP server:
 
 ```toml
 [mcp_servers.gobby]
-command = "uv"
-args = ["run", "gobby", "mcp-server"]
+command = "gobby"
+args = ["mcp-server"]
 ```
 
 **Gemini Antigravity** (`~/.gemini/antigravity/mcp_config.json`):
@@ -256,7 +315,7 @@ AI CLI (Claude/Gemini/Codex)
    Hook Dispatcher
         │ HTTP POST
         ▼
-  Gobby Daemon (:8765)
+  Gobby Daemon (:60887)
         │
    ┌────┴────┐
    ▼         ▼
@@ -298,9 +357,12 @@ Gobby exposes tools via MCP that your AI coding assistant can use:
 **Worktrees** (`gobby-worktrees`)  
 `create_worktree`, `spawn_agent_in_worktree`, `list_worktrees`
 
-**MCP Proxy**  
+**MCP Proxy**
 `list_mcp_servers`, `add_mcp_server`, `import_mcp_server`, `list_tools`, `get_tool_schema`, `call_tool`, `recommend_tools`
 
+**Skills** (`gobby-skills`)
+`list_skills`, `get_skill`, `search_skills`, `install_skill`, `remove_skill`, `update_skill`
+
 ## For AI Agents
 
 **If you're an AI agent reading this:** Check out [docs/AGENT_INSTRUCTIONS.md](docs/AGENT_INSTRUCTIONS.md) for your operating procedures, and [CLAUDE.md](CLAUDE.md) for Claude Code-specific guidance.
@@ -317,6 +379,10 @@ See [ROADMAP.md](ROADMAP.md) for the full plan, but highlights:
 
 **Vision:** Always local first, but Pro cloud features to keep the lights on: Fleet management (manage sessions across multiple machines), Plugin ecosystem, Team workflows, Enterprise hardening
 
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for release history and detailed changes.
+
 ## Development
 
 ```bash

{gobby-0.2.5 → gobby-0.2.7}/README.md

@@ -105,35 +105,92 @@ call_tool("gobby-worktrees", "spawn_agent_in_worktree", {
 })
 ```
 
-## Quick Start
+### 🔗 Claude Code Task Integration
+
+Gobby transparently intercepts Claude Code's built-in task system (TaskCreate, TaskUpdate, etc.) and syncs operations to Gobby's persistent task store. Benefits:
+
+- **Tasks persist** across sessions (unlike CC's session-scoped tasks)
+- **Commit linking** — tasks auto-link to git commits
+- **Validation gates** — define criteria for task completion
+- **LLM expansion** — break complex tasks into subtasks
+
+No configuration needed — just use Claude Code's native task tools and Gobby handles the rest.
+
+### 📚 Skills System
+
+Reusable instructions that teach agents how to perform specific tasks. Compatible with the [Agent Skills specification](https://agentskills.io) and SkillPort.
+
+- **Core skills** bundled with Gobby for tasks, sessions, memory, workflows
+- **Project skills** in `.gobby/skills/` for team-specific patterns
+- **Install from anywhere** — GitHub repos, local paths, ZIP archives
+- **Search and discovery** — TF-IDF and semantic search across your skill library
+
+```bash
+# Install a skill from GitHub
+gobby skills install github:user/repo/skills/my-skill
+
+# Search for relevant skills
+gobby skills search "testing coverage"
+```
+
+## Installation
+
+### Try it instantly
+```bash
+uvx gobby --help
+```
 
+### Install globally
 ```bash
-# Clone and install
-git clone https://github.com/GobbyAI/gobby.git
-cd gobby
-uv sync
+# With uv (recommended)
+uv tool install gobby
 
+# With pipx
+pipx install gobby
+
+# With pip
+pip install gobby
+```
+
+**Requirements:** Python 3.13+
+
+## Quick Start
+
+```bash
 # Start the daemon
-uv run gobby start
+gobby start
 
 # In your project directory
-uv run gobby init
-uv run gobby install  # Installs hooks for detected CLIs
-
-# Optional: install globally
-uv pip install -e .
+gobby init
+gobby install  # Installs hooks for detected CLIs
 ```
 
-**Requirements:** Python 3.11+, [uv](https://github.com/astral-sh/uv), at least one AI CLI ([Claude Code](https://claude.ai/code), [Gemini CLI](https://github.com/google-gemini/gemini-cli), or [Codex CLI](https://github.com/openai/codex))
+**Requirements:** At least one AI CLI ([Claude Code](https://claude.ai/code), [Gemini CLI](https://github.com/google-gemini/gemini-cli), or [Codex CLI](https://github.com/openai/codex))
 
 Works with your Claude, Gemini, or Codex subscriptions—or bring your own API keys. Local model support coming soon.
 
 ## Configure Your AI CLI
 
-Add Gobby as an MCP server:
+Add Gobby as an MCP server. Choose the `command` and `args` that match your installation:
+
+- **pip/pipx install**: `"command": "gobby"`, `"args": ["mcp-server"]`
+- **uv tool install**: `"command": "uv"`, `"args": ["run", "gobby", "mcp-server"]`
 
 **Claude Code** (`.mcp.json` or `~/.claude.json`):
 
+```json
+{
+  "mcpServers": {
+    "gobby": {
+      "command": "gobby",
+      "args": ["mcp-server"]
+    }
+  }
+}
+```
+
+Or with uv:
+
 ```json
 {
   "mcpServers": {
@@ -151,8 +208,8 @@ Add Gobby as an MCP server:
 {
   "mcpServers": {
     "gobby": {
-      "command": "uv",
-      "args": ["run", "gobby", "mcp-server"]
+      "command": "gobby",
+      "args": ["mcp-server"]
     }
   }
 }
@@ -162,8 +219,8 @@ Add Gobby as an MCP server:
 
 ```toml
 [mcp_servers.gobby]
-command = "uv"
-args = ["run", "gobby", "mcp-server"]
+command = "gobby"
+args = ["mcp-server"]
 ```
 
 **Gemini Antigravity** (`~/.gemini/antigravity/mcp_config.json`):
@@ -212,7 +269,7 @@ AI CLI (Claude/Gemini/Codex)
    Hook Dispatcher
         │ HTTP POST
         ▼
-  Gobby Daemon (:8765)
+  Gobby Daemon (:60887)
         │
    ┌────┴────┐
    ▼         ▼
@@ -254,9 +311,12 @@ Gobby exposes tools via MCP that your AI coding assistant can use:
 **Worktrees** (`gobby-worktrees`)  
 `create_worktree`, `spawn_agent_in_worktree`, `list_worktrees`
 
-**MCP Proxy**  
+**MCP Proxy**
 `list_mcp_servers`, `add_mcp_server`, `import_mcp_server`, `list_tools`, `get_tool_schema`, `call_tool`, `recommend_tools`
 
+**Skills** (`gobby-skills`)
+`list_skills`, `get_skill`, `search_skills`, `install_skill`, `remove_skill`, `update_skill`
+
 ## For AI Agents
 
 **If you're an AI agent reading this:** Check out [docs/AGENT_INSTRUCTIONS.md](docs/AGENT_INSTRUCTIONS.md) for your operating procedures, and [CLAUDE.md](CLAUDE.md) for Claude Code-specific guidance.
@@ -273,6 +333,10 @@ See [ROADMAP.md](ROADMAP.md) for the full plan, but highlights:
 
 **Vision:** Always local first, but Pro cloud features to keep the lights on: Fleet management (manage sessions across multiple machines), Plugin ecosystem, Team workflows, Enterprise hardening
 
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for release history and detailed changes.
+
 ## Development
 
 ```bash

{gobby-0.2.5 → gobby-0.2.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gobby"
-version = "0.2.5"
+version = "0.2.7"
 description = "A local-first daemon to unify your AI coding tools. Session tracking and handoffs across Claude Code, Gemini CLI, and Codex. An MCP proxy that discovers tools without flooding context. Task management with dependencies, validation, and TDD expansion. Agent spawning and worktree orchestration. Persistent memory, extensible workflows, and hooks."
 readme = "README.md"
 license = "MIT"
@@ -40,10 +40,15 @@ dependencies = [
     # scikit-learn for TF-IDF memory search
     "scikit-learn>=1.0.0",
     "textual>=7.3.0",
-    "mem0ai",
+    # mem0ai moved to optional [mem0] extra due to CVE-2026-0994 (protobuf<=6.33.4 vulnerable)
     "memu-py>=1.0.0",
+    # python-multipart 0.0.21 has CVE-2026-24486 - pin to fixed version
+    "python-multipart>=0.0.22",
 ]
 
+[project.optional-dependencies]
+mem0 = ["mem0ai"]
+
 [project.scripts]
 gobby = "gobby.cli:cli"
 
@@ -90,6 +95,8 @@ markers = [
     "slow: marks tests as slow (deselect with '-m \"not slow\"')",
     "integration: marks tests as integration tests",
     "e2e: marks tests as end-to-end tests",
+    "cli: marks tests as CLI command tests",
+    "no_config_protection: skip config protection for this test",
 ]
 filterwarnings = [
     # Ignore coroutine warnings from fire-and-forget async patterns in hook/webhook code
@@ -104,6 +111,8 @@ filterwarnings = [
     "ignore:unclosed database:ResourceWarning:coverage",
     "ignore:unclosed database:ResourceWarning:unittest.mock",
     "ignore:unclosed database:ResourceWarning",
+    # Ignore fork() deprecation warning from embedded spawner tests (expected on macOS)
+    "ignore:This process.*is multi-threaded.*use of fork:DeprecationWarning",
 ]
 
 [tool.ruff]

{gobby-0.2.5 → gobby-0.2.7}/src/gobby/__init__.py

@@ -1,3 +1,3 @@
 """Gobby - Local-first daemon for multi-CLI session management."""
 
-__version__ = "0.2.3"
+__version__ = "0.2.7"

{gobby-0.2.5 → gobby-0.2.7}/src/gobby/adapters/__init__.py

@@ -17,7 +17,8 @@ Adapters:
 
 from gobby.adapters.base import BaseAdapter
 from gobby.adapters.claude_code import ClaudeCodeAdapter
-from gobby.adapters.codex import CodexAdapter, CodexAppServerClient, CodexNotifyAdapter
+from gobby.adapters.codex_impl.adapter import CodexAdapter, CodexNotifyAdapter
+from gobby.adapters.codex_impl.client import CodexAppServerClient
 from gobby.adapters.gemini import GeminiAdapter
 
 __all__ = [

{gobby-0.2.5 → gobby-0.2.7}/src/gobby/adapters/claude_code.py

@@ -191,11 +191,17 @@ class ClaudeCodeAdapter(BaseAdapter):
             additional_context_parts.append(response.context)
 
         # Add session identifiers from metadata
+        # Note: "session_id" in metadata is Gobby's internal platform session ID
+        #       "external_id" in metadata is the CLI's session UUID
         if response.metadata:
-            session_id = response.metadata.get("session_id")
-            if session_id:
+            gobby_session_id = response.metadata.get("session_id")
+            external_id = response.metadata.get("external_id")
+            if gobby_session_id:
                 # Build context with all available identifiers
-                context_lines = [f"session_id: {session_id}"]
+                # Use clear naming: Gobby Session ID for MCP calls, External ID for transcripts
+                context_lines = [f"Gobby Session ID: {gobby_session_id}"]
+                if external_id:
+                    context_lines.append(f"External ID: {external_id}")
                 if response.metadata.get("parent_session_id"):
                     context_lines.append(
                         f"parent_session_id: {response.metadata['parent_session_id']}"
@@ -227,7 +233,10 @@ class ClaudeCodeAdapter(BaseAdapter):
                 additional_context_parts.append("\n".join(context_lines))
 
         # Build hookSpecificOutput if we have any context to inject
-        if additional_context_parts:
+        # Only include hookSpecificOutput for hook types that Claude Code's schema accepts
+        # Valid hookEventName values: PreToolUse, UserPromptSubmit, PostToolUse
+        valid_hook_event_names = {"PreToolUse", "UserPromptSubmit", "PostToolUse"}
+        if additional_context_parts and hook_event_name in valid_hook_event_names:
             result["hookSpecificOutput"] = {
                 "hookEventName": hook_event_name,
                 "additionalContext": "\n\n".join(additional_context_parts),

gobby-0.2.7/src/gobby/adapters/codex_impl/__init__.py

@@ -0,0 +1,28 @@
+"""
+Codex adapter implementation package.
+
+This package contains the decomposed implementation of the Codex adapter,
+extracted from the monolithic codex.py using the Strangler Fig pattern.
+
+Modules:
+- types.py: Type definitions and data classes
+- protocol.py: Protocol/interface definitions
+- client.py: CodexAppServerClient implementation
+- adapter.py: CodexAdapter and CodexNotifyAdapter implementations
+
+Importer analysis (from codex.py):
+- src/gobby/servers/http.py: imports CodexAdapter
+- src/gobby/servers/routes/mcp/hooks.py: imports CodexNotifyAdapter
+- src/gobby/adapters/__init__.py: imports CodexAdapter, CodexAppServerClient, CodexNotifyAdapter
+- tests/adapters/test_codex.py: imports various items for testing
+
+Migration strategy:
+1. Extract types/dataclasses to types.py
+2. Extract protocol definitions to protocol.py
+3. Extract CodexAppServerClient to client.py
+4. Extract adapters to adapter.py
+5. Update codex.py to re-export from submodules
+"""
+
+# Phase 3: Placeholders - exports will be added as code is migrated
+__all__: list[str] = []