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

hcom/__init__.py

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

hcom/__main__.py

@@ -724,7 +724,7 @@ def setup_hooks():
     if 'hooks' not in settings:
         settings['hooks'] = {}
     
-    hcom_send_permission = 'Bash(echo "HCOM_SEND:*")'
+    hcom_send_permission = 'Bash(echo HCOM_SEND:*)'
     if hcom_send_permission not in settings['permissions']['allow']:
         settings['permissions']['allow'].append(hcom_send_permission)
     
@@ -1292,6 +1292,7 @@ def show_main_screen_header():
 
 def cmd_help():
     """Show help text"""
+    # Basic help for interactive users
     print("""hcom - Claude Hook Comms
 
 Usage:
@@ -1305,12 +1306,59 @@ Usage:
   hcom help                    Show this help
 
 Automation:
-  hcom send 'msg'              Send message
+  hcom send 'msg'              Send message to all
   hcom send '@prefix msg'      Send to specific instances
   hcom watch --logs            Show logs
   hcom watch --status          Show status
+  hcom watch --wait [timeout]  Wait and notify for new messages (seconds)
 
 Docs: https://raw.githubusercontent.com/aannoo/claude-hook-comms/main/README.md""")
+    
+    # Additional help for AI assistants when running in non-interactive mode
+    if not sys.stdin.isatty():
+        print("""
+
+=== ADDITIONAL INFO ===
+
+CONCEPT: HCOM creates multi-agent collaboration by launching multiple Claude Code 
+instances in separate terminals that share a single conversation.
+
+KEY UNDERSTANDING:
+• Single conversation - All instances share ~/.hcom/hcom.log
+• Agents are system prompts - "reviewer" loads .claude/agents/reviewer.md
+• CLI usage - Use 'hcom send' for messaging. Internal instances use 'echo HCOM_SEND:'
+• hcom open is directory-specific - always cd to project directory first              
+
+LAUNCH PATTERNS:
+  hcom open 2 reviewer                   # 2 generic + 1 reviewer agent
+  hcom open reviewer reviewer            # 2 separate reviewer instances  
+  hcom open --prefix api 2               # Team naming: api-hova7, api-kolec
+  hcom open test --claude-args "-p 'write tests'"  # Pass 'claude' CLI flags
+
+@MENTION TARGETING:
+  hcom send "message"           # Broadcasts to everyone
+  hcom send "@api fix this"     # Targets all api-* instances (api-hova7, api-kolec)
+  hcom send "@hova7 status?"    # Targets specific instance
+  (Unmatched @mentions broadcast to everyone)
+
+STATUS INDICATORS:
+• ◉ thinking, ▷ responding, ▶ executing - instance is working
+• ◉ waiting - instance is waiting for new messages (hcom send)
+• ■ blocked - instance is blocked by permission request (needs user approval)
+• ○ inactive - instance is inactive (timed out, disconnected, etc)
+              
+CONFIG:
+Environment overrides (temporary): HCOM_INSTANCE_HINTS="useful info" hcom send "hi"
+Config file (persistent): ~/.hcom/config.json
+
+Key settings (all in config.json):
+  terminal_mode: "new_window" | "same_terminal" | "show_commands"
+  initial_prompt: "Say hi in chat", first_use_text: "Essential, concise messages only..."
+  instance_hints: "", cli_hints: ""  # Extra info for instances/CLI
+
+EXPECT: Instance names are auto-generated (5-char format based on uuid: "hova7"). Check actual names 
+with 'hcom watch --status'. Instances respond automatically in shared chat.""")
+    
     return 0
 
 def cmd_open(*args):

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hcom
-Version: 0.1.7
+Version: 0.1.8
 Summary: Lightweight CLI tool for real-time communication between Claude Code subagents using hooks
 Author-email: aannoo <your@email.com>
 License: MIT
@@ -92,7 +92,7 @@ hcom open test-writer --claude-args "-p 'write tests for any new code'"
 hcom open reviewer --claude-args "-p 'review when @mentioned'"
 
 # Pass multiple Claude flags
-hcom open orchestrator --claude-args "--model claude-3-opus 
+hcom open orchestrator --claude-args "--model sonnet 
 --resume session_id"
 
 # Launch in specific directories

hcom-0.1.8.dist-info/RECORD

@@ -0,0 +1,7 @@
+hcom/__init__.py,sha256=h_kF26j8HKI-8wQqLhfCVH-Qg6U5T_Im5sUNs6gneDE,96
+hcom/__main__.py,sha256=2ROTl8889tbhtw3Xas4CvL69O6gidJoeX7gtNo-ECiE,77437
+hcom-0.1.8.dist-info/METADATA,sha256=X5uTxHkelaG5rCVnUgIPkyTtPSqy-6E2e2_4iZml2B8,10363
+hcom-0.1.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+hcom-0.1.8.dist-info/entry_points.txt,sha256=cz9K9PsgYmORUxNKxVRrpxLS3cxRJcDZkE-PpfvOhI8,44
+hcom-0.1.8.dist-info/top_level.txt,sha256=8AS1nVUWA26vxjDQ5viRxgJnwSvUWk1W6GP4g6ldZ-0,5
+hcom-0.1.8.dist-info/RECORD,,

hcom-0.1.7.dist-info/RECORD

@@ -1,7 +0,0 @@
-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,,