hcom 0.1.5__py3-none-any.whl → 0.1.7__py3-none-any.whl

hcom/__init__.py

@@ -1,3 +1,3 @@
 """Claude Hook Comms - Real-time messaging between Claude Code agents."""
 
-__version__ = "0.1.5"
+__version__ = "0.1.7"

hcom/__main__.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """
 hcom - Claude Hook Comms
-A lightweight multi-agent communication system for claude code
+Lightweight CLI tool for real-time communication between Claude Code subagents using hooks
 """
 
 import os
@@ -170,27 +170,22 @@ def get_config_value(key, default=None):
     return config.get(key, default)
 
 def get_hook_command():
-    """Determine the best hook command approach based on paths"""
+    """Get hook command with silent fallback
+    
+    Uses ${HCOM:-true} for clean paths, conditional for paths with spaces.
+    Both approaches exit silently (code 0) when not launched via 'hcom open'.
+    """
     python_path = sys.executable
     script_path = os.path.abspath(__file__)
     
-    # Characters that cause issues in shell expansion
-    problematic_chars = [' ', '`', '"', "'", '\\', '\n', ';', '&', '|', '(', ')', ':', 
-                        '$', '*', '?', '[', ']', '{', '}', '!', '~', '<', '>']
-    
-    has_problematic_chars = any(char in python_path or char in script_path 
-                               for char in problematic_chars)
-    
-    if has_problematic_chars:
-        # Use direct paths with proper escaping
-        # Escape backslashes first, then quotes
-        escaped_python = python_path.replace('\\', '\\\\').replace('"', '\\"')
-        escaped_script = script_path.replace('\\', '\\\\').replace('"', '\\"')
-        return f'"{escaped_python}" "{escaped_script}"', {}
+    if ' ' in python_path or ' ' in script_path:
+        # Paths with spaces: use conditional check
+        escaped_python = shlex.quote(python_path)
+        escaped_script = shlex.quote(script_path)
+        return f'[ "${{HCOM_ACTIVE}}" = "1" ] && {escaped_python} {escaped_script} || true', {}
     else:
-        # Use single clean env var
-        env_vars = {'HCOM': f'{python_path} {script_path}'}
-        return '$HCOM', env_vars
+        # Clean paths: use environment variable
+        return '${HCOM:-true}', {}
 
 def build_claude_env():
     """Build environment variables for Claude instances"""
@@ -206,9 +201,11 @@ def build_claude_env():
     
     env.update(config.get('env_overrides', {}))
     
-    # Add hook-specific env vars if using that approach
-    _, hook_env_vars = get_hook_command()
-    env.update(hook_env_vars)
+    # Set HCOM only for clean paths (spaces handled differently)
+    python_path = sys.executable
+    script_path = os.path.abspath(__file__)
+    if ' ' not in python_path and ' ' not in script_path:
+        env['HCOM'] = f'{python_path} {script_path}'
     
     return env
 
@@ -265,7 +262,7 @@ def send_message(from_instance, message):
     except Exception:
         return False
 
-def should_deliver_message(msg, instance_name):
+def should_deliver_message(msg, instance_name, all_instance_names=None):
     """Check if message should be delivered based on @-mentions"""
     text = msg['message']
     
@@ -277,11 +274,22 @@ def should_deliver_message(msg, instance_name):
     if not mentions:
         return True
     
-    for mention in mentions:
-        if instance_name.lower().startswith(mention.lower()):
-            return True
+    # Check if this instance matches any mention
+    this_instance_matches = any(instance_name.lower().startswith(mention.lower()) for mention in mentions)
+    
+    if this_instance_matches:
+        return True
+    
+    # If we have all_instance_names, check if ANY mention matches ANY instance
+    if all_instance_names:
+        any_mention_matches = any(
+            any(name.lower().startswith(mention.lower()) for name in all_instance_names)
+            for mention in mentions
+        )
+        if not any_mention_matches:
+            return True  # No matches anywhere = broadcast to all
     
-    return False
+    return False  # This instance doesn't match, but others might
 
 # ==================== Parsing and Helper Functions ====================
 
@@ -423,15 +431,22 @@ def _remove_hcom_hooks_from_settings(settings):
     
     # Patterns to match any hcom hook command
     # - $HCOM post/stop/notify
+    # - ${HCOM:-...} post/stop/notify
+    # - [ "${HCOM_ACTIVE}" = "1" ] && ... hcom.py ... || true
     # - hcom post/stop/notify  
+    # - uvx hcom post/stop/notify
     # - /path/to/hcom.py post/stop/notify
+    # - sh -c "[ ... ] && ... hcom ..."
     # - "/path with spaces/python" "/path with spaces/hcom.py" post/stop/notify
     # - '/path/to/python' '/path/to/hcom.py' post/stop/notify
     hcom_patterns = [
-        r'\$HCOM\s+(post|stop|notify)\b',           # Environment variable
+        r'\$\{?HCOM',                                # Environment variable (with or without braces)
+        r'\bHCOM_ACTIVE.*hcom\.py',                 # Conditional with HCOM_ACTIVE check
         r'\bhcom\s+(post|stop|notify)\b',           # Direct hcom command
+        r'\buvx\s+hcom\s+(post|stop|notify)\b',     # uvx hcom command
         r'hcom\.py["\']?\s+(post|stop|notify)\b',   # hcom.py with optional quote
         r'["\'][^"\']*hcom\.py["\']?\s+(post|stop|notify)\b',  # Quoted path with hcom.py
+        r'sh\s+-c.*hcom',                           # Shell wrapper with hcom
     ]
     compiled_patterns = [re.compile(pattern) for pattern in hcom_patterns]
     
@@ -713,7 +728,7 @@ def setup_hooks():
     if hcom_send_permission not in settings['permissions']['allow']:
         settings['permissions']['allow'].append(hcom_send_permission)
     
-    # Get the hook command approach (env vars or direct paths based on spaces)
+    # Get the hook command template
     hook_cmd_base, _ = get_hook_command()
     
     # Add PostToolUse hook
@@ -881,10 +896,11 @@ def get_new_messages(instance_name):
     # Filter messages:
     # 1. Exclude own messages
     # 2. Apply @-mention filtering
+    all_instance_names = list(positions.keys())
     messages = []
     for msg in all_messages:
         if msg['from'] != instance_name:
-            if should_deliver_message(msg, instance_name):
+            if should_deliver_message(msg, instance_name, all_instance_names):
                 messages.append(msg)
     
     # Update position to end of file
@@ -1280,18 +1296,21 @@ def cmd_help():
 
 Usage:
   hcom open [n]                Launch n Claude instances
-  hcom open --prefix name n    Launch with name prefix
+  hcom open <agent>            Launch named agent from .claude/agents/
+  hcom open --prefix <team> n  Launch n instances with team prefix
   hcom watch                   View conversation dashboard
-  hcom clear                 Clear and archive conversation
-  hcom cleanup               Remove hooks from current directory
-  hcom cleanup --all         Remove hooks from all tracked directories
-  hcom help                  Show this help
+  hcom clear                   Clear and archive conversation
+  hcom cleanup                 Remove hooks from current directory
+  hcom cleanup --all           Remove hooks from all tracked directories
+  hcom help                    Show this help
 
 Automation:
-  hcom send 'msg'            Send message
-  hcom send '@prefix msg'    Send to specific instances
-  hcom watch --logs          Show logs
-  hcom watch --status        Show status""")
+  hcom send 'msg'              Send message
+  hcom send '@prefix msg'      Send to specific instances
+  hcom watch --logs            Show logs
+  hcom watch --status          Show status
+
+Docs: https://raw.githubusercontent.com/aannoo/claude-hook-comms/main/README.md""")
     return 0
 
 def cmd_open(*args):
@@ -1779,6 +1798,19 @@ def cmd_send(message):
         print(f"Error: {error}", file=sys.stderr)
         return 1
     
+    # Check for unmatched mentions (minimal warning)
+    mentions = MENTION_PATTERN.findall(message)
+    if mentions and pos_file.exists():
+        try:
+            positions = load_positions(pos_file)
+            all_instances = list(positions.keys())
+            unmatched = [m for m in mentions 
+                        if not any(name.lower().startswith(m.lower()) for name in all_instances)]
+            if unmatched:
+                print(f"Note: @{', @'.join(unmatched)} don't match any instances - broadcasting to all")
+        except Exception:
+            pass  # Don't fail on warning
+    
     # Send message
     sender_name = get_config_value('sender_name', 'bigboss')
     

{hcom-0.1.5.dist-info → hcom-0.1.7.dist-info}/METADATA

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: hcom
-Version: 0.1.5
-Summary: Lightweight CLI tool for real-time messaging between Claude Code subagents using hooks
+Version: 0.1.7
+Summary: Lightweight CLI tool for real-time communication between Claude Code subagents using hooks
 Author-email: aannoo <your@email.com>
 License: MIT
 Project-URL: Homepage, https://github.com/aannoo/claude-hook-comms
@@ -26,9 +26,9 @@ Classifier: Topic :: Communications
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 
-# Claude Code Hook Comms
+# hcom - Claude Hook Comms
 
-Lightweight CLI tool for real-time communication between claude code [subagents](https://docs.anthropic.com/en/docs/claude-code/sub-agents) using [hooks](https://docs.anthropic.com/en/docs/claude-code/hooks).
+Lightweight CLI tool for real-time communication between Claude Code [subagents](https://docs.anthropic.com/en/docs/claude-code/sub-agents) using [hooks](https://docs.anthropic.com/en/docs/claude-code/hooks).
 
 ## 🦆 What It Does
 
@@ -38,7 +38,7 @@ Creates a group chat where you and multiple interactive Claude Code subagents ca
 
 ## 🦷 Features
 
-- **Multi-Terminal Launch** - Launch claude code subagents in new terminals
+- **Multi-Terminal Launch** - Launch Claude Code subagents in new terminals
 - **Live Dashboard** - Real-time monitoring of all instances
 - **Multi-Agent Communication** - Claude instances talk to each other across projects
 - **@Mention Targeting** - Send messages to specific subagents or teams
@@ -100,11 +100,12 @@ cd backend && hcom open api-specialist
 cd ../frontend && hcom open ui-specialist
 
 # Create named teams that can be @mentioned
-cd ~/api && hcom open --prefix api debugger
-cd ~/auth && hcom open --prefix auth debugger
+cd ~/api && hcom open --prefix api debugger  # Creates api-hovoa7
+cd ~/auth && hcom open --prefix auth debugger  # Creates auth-hovob8
 
-# Message specific teams
-hcom send "@api login works but API fails" # or in dashboard: hcom watch
+# Message specific teams or instances
+hcom send "@api login works but API fails"  # Messages all api-* instances
+hcom send "@hovoa7 can you check this?"     # Message specific instance by name
 ```
 
 
@@ -120,7 +121,7 @@ hcom send "@api login works but API fails" # or in dashboard: hcom watch
 ### Automation Commands
 | Command | Description |
 |---------|-------------|
-| `hcom send 'message'` | Send message |
+| `hcom send 'message'` | Send message to chat |
 | `hcom watch --logs` | View message history (non-interactive) |
 | `hcom watch --status` | Show instance status (non-interactive) |
 | `hcom watch --wait [timeout]` | Wait and notify for new messages |
@@ -195,18 +196,18 @@ HCOM_MAX_MESSAGE_SIZE=8192 hcom send "$(cat long_report.txt)"
 
 hcom adds hooks to your project directory's `.claude/settings.local.json`:
 
-1. **Sending**: Claude writes messages with `echo "HCOM_SEND:message"` - captured by PostToolUse hook
+1. **Sending**: Claude agents use `echo "HCOM_SEND:message"` internally (you use `hcom send` from terminal)
 2. **Receiving**: Other Claudes get notified via Stop hook
 3. **Waiting**: Stop hook keeps Claude in a waiting state for new messages
 
 - **Identity**: Each instance gets a unique name based on conversation UUID (e.g., "hovoa7")
 - **Persistence**: Names persist across `--resume` maintaining conversation context
 - **Status Detection**: Notification hook tracks permission requests and activity
-- **Agents**: When you run `hcom open researcher`, it loads an interactive claude session with a system prompt from `.claude/agents/researcher.md` (local) or `~/.claude/agents/researcher.md` (global). Agents can specify `model:` and `tools:` in YAML frontmatter
+- **Agents**: When you run `hcom open researcher`, it loads an interactive Claude session with a system prompt from `.claude/agents/researcher.md` (local) or `~/.claude/agents/researcher.md` (global). Agents can specify `model:` and `tools:` in YAML frontmatter
 
 ### Architecture
 - **Single conversation** - All instances share one global conversation
-- **Opt-in participation** - Only claude code instances launched with `hcom open` join the chat
+- **Opt-in participation** - Only Claude Code instances launched with `hcom open` join the chat
 - **@-mention filtering** - Target messages to specific instances or teams
 
 ### File Structure

hcom-0.1.7.dist-info/RECORD

@@ -0,0 +1,7 @@
+hcom/__init__.py,sha256=yxqzLIr5XxsUrfSe-inggLeqMM300Z4PrewklOE1FCk,96
+hcom/__main__.py,sha256=VsTjMMUpknJ_D638HT9KrLX7Aid0c9dPq8p020c5gZA,75178
+hcom-0.1.7.dist-info/METADATA,sha256=rYV5yFW1j2FFvxKSvKrSKzGSq3FzFrM3pD04x2xRpwY,10370
+hcom-0.1.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+hcom-0.1.7.dist-info/entry_points.txt,sha256=cz9K9PsgYmORUxNKxVRrpxLS3cxRJcDZkE-PpfvOhI8,44
+hcom-0.1.7.dist-info/top_level.txt,sha256=8AS1nVUWA26vxjDQ5viRxgJnwSvUWk1W6GP4g6ldZ-0,5
+hcom-0.1.7.dist-info/RECORD,,

hcom-0.1.5.dist-info/RECORD

@@ -1,7 +0,0 @@
-hcom/__init__.py,sha256=21Stc_3iuK1pjO6Nhkq7JmBYyatpk5yhMR0iSZ9U7eA,96
-hcom/__main__.py,sha256=BAgC4SZoZznLG4Xd6Hjs3guCRV3iHg1vlgVxQ5wv9nw,73545
-hcom-0.1.5.dist-info/METADATA,sha256=dzIT8zFctb5xaApTRtmEbh6e1Wj8pdg0hOl2X7LsuPc,10210
-hcom-0.1.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-hcom-0.1.5.dist-info/entry_points.txt,sha256=cz9K9PsgYmORUxNKxVRrpxLS3cxRJcDZkE-PpfvOhI8,44
-hcom-0.1.5.dist-info/top_level.txt,sha256=8AS1nVUWA26vxjDQ5viRxgJnwSvUWk1W6GP4g6ldZ-0,5
-hcom-0.1.5.dist-info/RECORD,,