PyPI - hcom - Versions diffs - 0.1.0__tar.gz → 0.1.1__tar.gz - Mend

hcom 0.1.0tar.gz → 0.1.1tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of hcom might be problematic. Click here for more details.

Files changed (20) hide show

{hcom-0.1.0 → hcom-0.1.1}/PKG-INFO RENAMED Viewed

@@ -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.0 → hcom-0.1.1}/README.md RENAMED Viewed

@@ -1,6 +1,6 @@
 # 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
@@ -10,7 +10,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
@@ -18,35 +18,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
@@ -55,7 +57,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"
@@ -64,7 +66,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'
@@ -80,6 +82,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
@@ -199,22 +226,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)
@@ -225,15 +239,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:
@@ -251,13 +260,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.0 → hcom-0.1.1}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "hcom"
-version = "0.1.0"
+version = "0.1.1"
 description = "Lightweight CLI tool for real-time messaging between Claude Code instances/subagents using hooks"
 readme = "README.md"
 requires-python = ">=3.6"

{hcom-0.1.0 → hcom-0.1.1}/src/hcom/__main__.py RENAMED Viewed

@@ -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 → hcom-0.1.1}/src/hcom.egg-info/PKG-INFO RENAMED Viewed

@@ -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
 {