hcom 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

hcom/__main__.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """
-Claude Hook Comms
-A lightweight multi-agent communication and launching system for Claude instances
+hcom - Hook Communications
+A simplified multi-agent communication system for Claude instances
 """
 
 import os
@@ -390,7 +390,11 @@ def build_env_string(env_vars, format_type="bash"):
         return ' '.join(f'export {k}={shlex.quote(str(v))};' for k, v in env_vars.items())
     elif format_type == "powershell":
         # PowerShell environment variable syntax
-        return ' ; '.join(f'$env:{k}="{str(v).replace('"', '`"')}"' for k, v in env_vars.items())
+        items = []
+        for k, v in env_vars.items():
+            escaped_value = str(v).replace('"', '`"')
+            items.append(f'$env:{k}="{escaped_value}"')
+        return ' ; '.join(items)
     else:
         return ' '.join(f'{k}={shlex.quote(str(v))}' for k, v in env_vars.items())
 

{hcom-0.1.0.dist-info → hcom-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hcom
-Version: 0.1.0
+Version: 0.1.1
 Summary: Lightweight CLI tool for real-time messaging between Claude Code instances/subagents using hooks
 Author-email: aannoo <your@email.com>
 License: MIT
@@ -28,7 +28,7 @@ Description-Content-Type: text/markdown
 
 # Claude Code Hook Comms
 
-Lightweight CLI tool for real-time messaging between Claude Code instances/subagents using [hooks](https://docs.anthropic.com/en/docs/claude-code/hooks).
+Lightweight CLI tool for launching and real-time communication between claude code subagents/instances 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
 
 ## 🦷 Key Features
 
-- **New Window** - Claude subagents open in new terminals
+- **New Terminal Window** - Launch claude code subagents in new terminals
 - **Multi-Agent Communication** - Claude instances talk to each other across projects
 - **@Mention Targeting** - Send messages to specific subagents or teams
 - **Live Dashboard** - Real-time monitoring of all instances
@@ -46,35 +46,37 @@ Creates a group chat where you and multiple interactive Claude Code subagents ca
 
 ## 🎪 Quick Start
 
-### Download
+### Use Without Installing
 ```bash
-curl -sL https://raw.githubusercontent.com/aannoo/claude-hook-comms/main/hcom.py | sudo tee /usr/local/bin/hcom > /dev/null && sudo chmod +x /usr/local/bin/hcom
+uvx hcom open 2
 ```
 
-<details>
-<summary><strong>🦑 Windows</strong></summary>
-
-```powershell
-# Download Python file
-Invoke-WebRequest -Uri "https://raw.githubusercontent.com/aannoo/claude-hook-comms/main/hcom.py" -OutFile "hcom.py"
-
-# Run python file directly
-python path/to/hcom.py open 2
-```
-</details>
+*[ Installation Options](#-installation-options)*
 
 ### Usage
 ```bash
-# 1. Launch 3 Claude instances connected to group chat
-hcom open 3
+# Launch 3 default Claude instances connected to group chat
+uvx hcom open 3
 
-# 2. View/send messages in dashboard
-hcom watch
+# Launch researcher and code-writer from your .claude/agents
+uvx hcom open researcher code-writer
+
+# View/send messages in dashboard
+uvx hcom watch
+
+# Clear messages
+uvx hcom clear
 ```
 
+## 🦐 Requirements
+
+- Python 3.6+
+- [Claude Code](https://claude.ai/code)
+
 
+### More Launch Examples
 
-### Launch Claude Code Agents
+#### Launch Claude Code Agents
 ```bash
 # Launch researcher and code-writer from your .claude/agents
 hcom open researcher code-writer
@@ -83,7 +85,7 @@ hcom open researcher code-writer
 hcom open backend-coder frontend-coder orchestrator tester
 ```
 
-### Launch Headless Mode
+#### Launch Headless Mode
 ```bash
 # Launch researcher and code-writer from your .claude/agents and work in background
 hcom open researcher code-writer --claude-args "-p"
@@ -92,7 +94,7 @@ hcom open researcher code-writer --claude-args "-p"
 hcom open --claude-args "-p 'review git code changes when you get notified'"
 ```
 
-### Launch with Options
+#### Launch with Options
 ```bash
 # Launch researcher and code-writer from your .claude/agents and work in background
 hcom open researcher code-writer --prefix 'greenteam'
@@ -108,6 +110,31 @@ hcom open 2 backend-coder frontend-coder
 - Python 3.6+
 - [Claude Code](https://claude.ai/code)
 
+## 🦒 Installation Options
+
+**Option 1: Use without installing (uvx) - recommended**
+```bash
+uvx hcom open 3  # Runs latest version, no installation needed
+```
+
+**Option 2: Install with uv**
+```bash
+uv tool install hcom
+hcom open 3
+```
+
+**Option 3: Install with pip**
+```bash
+pip install hcom
+hcom open 3
+```
+
+**Option 4: Download script directly**
+```bash
+curl -sL https://raw.githubusercontent.com/aannoo/claude-hook-comms/main/hcom.py > hcom
+chmod +x hcom
+./hcom open 3
+```
 
 ## 🥨 Commands
 
@@ -227,22 +254,9 @@ your-project/
 
 
 <details>
-<summary><strong>🧈 Launching Claude Code</strong></summary>
-
-### Launching Claude Code
-
-Use `hcom open` to automatically launch Claude instances with proper setup:
-
-```bash
-# Launch 3 generic instances
-hcom open 3
+<summary><strong>🥔 Terminal Customization</strong></summary>
 
-# Launch with custom terminal mode
-hcom open 2  # Uses terminal_mode from config
-
-# Launch named agents
-hcom open writer researcher
-```
+### Terminal Mode
 
 Configure terminal behavior in `~/.hcom/config.json`:
 - `"terminal_mode": "new_window"` - Opens new terminal windows (default)
@@ -253,15 +267,10 @@ Configure terminal behavior in `~/.hcom/config.json`:
 ```bash
 # For single instance work
 HCOM_TERMINAL_MODE=same_terminal hcom open
-# This runs Claude directly in your current terminal
+# This runs Claude code directly in your current terminal
 ```
 
-</details>
-
-<details>
-<summary><strong>🥔 Integrations</strong></summary>
-
-### Custom Terminal Integration
+### Custom Terminal Examples
 
 Configure `terminal_command` in `~/.hcom/config.json` to use your preferred terminal:
 
@@ -279,13 +288,6 @@ Configure `terminal_command` in `~/.hcom/config.json` to use your preferred term
 }
 ```
 
-### Windows Terminal
-```json
-{
-  "terminal_command": "wt new-tab cmd /k \"{env} & {cmd}\""
-}
-```
-
 ### Kitty
 ```json
 {

hcom-0.1.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+hcom/__init__.py,sha256=TF-Q3b4Xkh9LTXMYh4JS-zHGLmVx9hiNqeU0lilogYw,96
+hcom/__main__.py,sha256=ndSRUGtDduwo4-FB-cnThy2Ij7ZfNuLpF-ctGcaOacc,68808
+hcom-0.1.1.dist-info/METADATA,sha256=n9zEinwdkRlLn3a4ScwwieN76gMYd1w_EuHisSJ11Dw,10494
+hcom-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+hcom-0.1.1.dist-info/entry_points.txt,sha256=cz9K9PsgYmORUxNKxVRrpxLS3cxRJcDZkE-PpfvOhI8,44
+hcom-0.1.1.dist-info/top_level.txt,sha256=8AS1nVUWA26vxjDQ5viRxgJnwSvUWk1W6GP4g6ldZ-0,5
+hcom-0.1.1.dist-info/RECORD,,

hcom-0.1.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-hcom/__init__.py,sha256=TF-Q3b4Xkh9LTXMYh4JS-zHGLmVx9hiNqeU0lilogYw,96
-hcom/__main__.py,sha256=TIdmomB1z9SPco-Oidt6AloE5-abhS6aanhLUpRzk7s,68712
-hcom-0.1.0.dist-info/METADATA,sha256=O2sTsNatksZ1SVwl2dPbprJKI0gRLeOFUlHMPDvtrg4,10545
-hcom-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-hcom-0.1.0.dist-info/entry_points.txt,sha256=cz9K9PsgYmORUxNKxVRrpxLS3cxRJcDZkE-PpfvOhI8,44
-hcom-0.1.0.dist-info/top_level.txt,sha256=8AS1nVUWA26vxjDQ5viRxgJnwSvUWk1W6GP4g6ldZ-0,5
-hcom-0.1.0.dist-info/RECORD,,