gobby 0.2.5__tar.gz → 0.2.6__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gobby
-Version: 0.2.5
+Version: 0.2.6
 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,9 @@ 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
+Provides-Extra: mem0
+Requires-Dist: mem0ai; extra == "mem0"
 Dynamic: license-file
 
 <!-- markdownlint-disable MD033 MD041 -->
@@ -149,35 +150,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
-# Clone and install
-git clone https://github.com/GobbyAI/gobby.git
-cd gobby
-uv sync
+# 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
+# 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 +253,8 @@ Add Gobby as an MCP server:
 {
   "mcpServers": {
     "gobby": {
-      "command": "uv",
-      "args": ["run", "gobby", "mcp-server"]
+      "command": "gobby",
+      "args": ["mcp-server"]
     }
   }
 }
@@ -206,8 +264,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 +314,7 @@ AI CLI (Claude/Gemini/Codex)
    Hook Dispatcher
         │ HTTP POST
         ▼
-  Gobby Daemon (:8765)
+  Gobby Daemon (:60887)
         │
    ┌────┴────┐
    ▼         ▼
@@ -298,9 +356,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.

{gobby-0.2.5 → gobby-0.2.6}/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
-# Clone and install
-git clone https://github.com/GobbyAI/gobby.git
-cd gobby
-uv sync
+# 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
+# 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.

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

@@ -1,6 +1,6 @@
 [project]
 name = "gobby"
-version = "0.2.5"
+version = "0.2.6"
 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,13 @@ 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",
 ]
 
+[project.optional-dependencies]
+mem0 = ["mem0ai"]
+
 [project.scripts]
 gobby = "gobby.cli:cli"
 
@@ -90,6 +93,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 +109,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.6}/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.5 → gobby-0.2.6}/src/gobby/adapters/codex.py

@@ -775,6 +775,28 @@ class CodexAdapter(BaseAdapter):
         "item/completed": HookEventType.AFTER_TOOL,
     }
 
+    # Tool name mapping: Codex tool names -> canonical CC-style names
+    # Codex uses different tool names - normalize to Claude Code conventions
+    # so block_tools rules work across CLIs
+    TOOL_MAP: dict[str, str] = {
+        # File operations
+        "read_file": "Read",
+        "ReadFile": "Read",
+        "write_file": "Write",
+        "WriteFile": "Write",
+        "edit_file": "Edit",
+        "EditFile": "Edit",
+        # Shell
+        "run_shell_command": "Bash",
+        "RunShellCommand": "Bash",
+        "commandExecution": "Bash",
+        # Search
+        "glob": "Glob",
+        "grep": "Grep",
+        "GlobTool": "Glob",
+        "GrepTool": "Grep",
+    }
+
     # Item types that represent tool operations
     TOOL_ITEM_TYPES = {"commandExecution", "fileChange", "mcpToolCall"}
 
@@ -814,6 +836,19 @@ class CodexAdapter(BaseAdapter):
             self._machine_id = _get_machine_id()
         return self._machine_id
 
+    def normalize_tool_name(self, codex_tool_name: str) -> str:
+        """Normalize Codex tool name to canonical CC-style format.
+
+        This ensures block_tools rules work consistently across CLIs.
+
+        Args:
+            codex_tool_name: Tool name from Codex CLI.
+
+        Returns:
+            Normalized tool name (e.g., "Bash", "Read", "Write", "Edit").
+        """
+        return self.TOOL_MAP.get(codex_tool_name, codex_tool_name)
+
     def attach_to_client(self, codex_client: CodexAppServerClient) -> None:
         """Attach to an existing CodexAppServerClient for event handling.
 
@@ -876,14 +911,17 @@ class CodexAdapter(BaseAdapter):
         thread_id = params.get("threadId", "")
         item_id = params.get("itemId", "")
 
-        # Determine tool name from method
+        # Determine tool name from method and normalize to CC-style
         if "commandExecution" in method:
-            tool_name = "Bash"
+            original_tool = "commandExecution"
+            tool_name = self.normalize_tool_name(original_tool)  # -> "Bash"
             tool_input = params.get("parsedCmd", params.get("command", ""))
         elif "fileChange" in method:
-            tool_name = "Write"
+            original_tool = "fileChange"
+            tool_name = "Write"  # File changes are writes
             tool_input = params.get("changes", [])
         else:
+            original_tool = "unknown"
             tool_name = "unknown"
             tool_input = params
 
@@ -905,6 +943,8 @@ class CodexAdapter(BaseAdapter):
                 "requires_response": True,
                 "item_id": item_id,
                 "approval_method": method,
+                "original_tool_name": original_tool,
+                "normalized_tool_name": tool_name,
             },
         )
 

{gobby-0.2.5 → gobby-0.2.6}/src/gobby/agents/runner.py

@@ -607,6 +607,14 @@ class AgentRunner:
             else:
                 self._session_storage.update_status(child_session.id, "failed")
 
+            # Persist cost to session storage for budget tracking
+            if result.cost_info and result.cost_info.total_cost > 0:
+                self._session_storage.add_cost(child_session.id, result.cost_info.total_cost)
+                self.logger.debug(
+                    f"Persisted cost ${result.cost_info.total_cost:.4f} "
+                    f"for session {child_session.id}"
+                )
+
             # Remove from in-memory tracking
             self._untrack_running_agent(agent_run.id)
 

{gobby-0.2.5 → gobby-0.2.6}/src/gobby/cli/__init__.py

@@ -8,6 +8,8 @@ from gobby.config.app import load_config
 
 from .agents import agents
 from .artifacts import artifacts
+from .clones import clones
+from .conductor import conductor
 from .daemon import restart, start, status, stop
 from .extensions import hooks, plugins, webhooks
 from .github import github
@@ -20,6 +22,7 @@ from .memory import memory
 from .merge import merge
 from .projects import projects
 from .sessions import sessions
+from .skills import skills
 from .tasks import tasks
 from .tui import ui
 from .workflows import workflows
@@ -52,6 +55,7 @@ cli.add_command(uninstall)
 cli.add_command(tasks)
 cli.add_command(memory)
 cli.add_command(sessions)
+cli.add_command(skills)
 cli.add_command(agents)
 cli.add_command(worktrees)
 cli.add_command(mcp_proxy)
@@ -61,6 +65,8 @@ cli.add_command(merge)
 cli.add_command(artifacts)
 cli.add_command(github)
 cli.add_command(linear)
+cli.add_command(clones)
+cli.add_command(conductor)
 cli.add_command(hooks)
 cli.add_command(plugins)
 cli.add_command(webhooks)