hcom 0.1.8__tar.gz → 0.2.0__tar.gz

{hcom-0.1.8 → hcom-0.2.0}/MANIFEST.in

@@ -3,6 +3,7 @@ include pyproject.toml
 recursive-include src/hcom *.py
 global-exclude __pycache__
 global-exclude *.py[co]
+prune test
 prune tests
 prune docs
 prune old

{hcom-0.1.8/src/hcom.egg-info → hcom-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hcom
-Version: 0.1.8
+Version: 0.2.0
 Summary: Lightweight CLI tool for real-time communication between Claude Code subagents using hooks
 Author-email: aannoo <your@email.com>
 License: MIT
@@ -66,7 +66,7 @@ uv tool install hcom
 # or pip
 pip install hcom
 # then use with:
-hcom open 3
+hcom open
 ```
 
 
@@ -85,15 +85,18 @@ hcom open 2 backend-coder frontend-coder
 # Launch multiple of the same agent
 hcom open reviewer reviewer reviewer  # 3 separate reviewers
 
-# Launch agents in background with specific prompts
-hcom open test-writer --claude-args "-p 'write tests for any new code'"
+# Launch instances as background processes (no terminal window, managed with 'hcom kill')
+hcom open --background
+hcom open -p 2 code-writer    # -p is shorthand for --background
 
-# Launch watchers that respond to notifications
-hcom open reviewer --claude-args "-p 'review when @mentioned'"
+# Launch agent with specific prompt
+HCOM_INITIAL_PROMPT='write tests' hcom open test-writer
+
+# Resume instance (hcom chat will continue)
+hcom open --claude-args "--resume session_id"  # get session_id from hcom watch
 
 # Pass multiple Claude flags
-hcom open orchestrator --claude-args "--model sonnet 
---resume session_id"
+hcom open orchestrator --claude-args "--model sonnet --resume session_id"
 
 # Launch in specific directories
 cd backend && hcom open api-specialist
@@ -114,9 +117,11 @@ hcom send "@hovoa7 can you check this?"     # Message specific instance by name
 | Command | Description |
 |---------|-------------|
 | `hcom open [n]` | Launch n Claude instances (or named agents) |
+| `hcom open -p` | Launch instances as background processes |
 | `hcom watch` | Conversation/status dashboard |
 | `hcom clear` | Clear and archive conversation |
 | `hcom cleanup` | Remove HCOM hooks from current directory |
+| `hcom kill [name]` | Kill specific instance or all with --all |
 
 ### Automation Commands
 | Command | Description |
@@ -167,10 +172,10 @@ HCOM_INSTANCE_HINTS="always update chat with progress" hcom open nice-subagent-b
 
 ```bash
 # Change your name for one command
-HCOM_SENDER_NAME="reviewer" hcom send "LGTM!"
+HCOM_SENDER_NAME="coolguy" hcom send "LGTM!"
 
-# Make instances wait 30 minutes instead of 10
-HCOM_WAIT_TIMEOUT=1800 hcom open 3
+# Make instances timeout after 60 seconds instead of 30 minutes
+HCOM_WAIT_TIMEOUT=60 hcom open 3
 
 # Custom welcome message
 HCOM_FIRST_USE_TEXT="Debug session for issue #123" hcom open 2
@@ -186,6 +191,7 @@ HCOM_MAX_MESSAGE_SIZE=8192 hcom send "$(cat long_report.txt)"
 - ◉ **waiting** (blue) - Waiting for messages
 - ■ **blocked** (yellow) - Permission blocked
 - ○ **inactive** (red) - Timed out/dead
+- **(bg)** suffix - Instance running in background mode
 
 </details>
 
@@ -214,8 +220,10 @@ hcom adds hooks to your project directory's `.claude/settings.local.json`:
 ```
 ~/.hcom/                             
 ├── hcom.log       # Conversation log
-├── hcom.json      # Instance tracking
-└── config.json    # Configuration
+├── instances/     # Instance tracking
+├── logs/          # Background process logs
+├── config.json    # Configuration
+└── archive/       # Archived sessions
 
 your-project/  
 └── .claude/
@@ -308,6 +316,15 @@ Configure `terminal_command` in `~/.hcom/config.json` to use your preferred term
 hcom clear
 ```
 
+### Kill Running Instances
+```bash
+# Kill specific instance
+hcom kill hovoa7
+
+# Kill all instances
+hcom kill --all
+```
+
 ### Remove HCOM hooks from current directory
 ```bash
 hcom cleanup

{hcom-0.1.8 → hcom-0.2.0}/README.md

@@ -38,7 +38,7 @@ uv tool install hcom
 # or pip
 pip install hcom
 # then use with:
-hcom open 3
+hcom open
 ```
 
 
@@ -57,15 +57,18 @@ hcom open 2 backend-coder frontend-coder
 # Launch multiple of the same agent
 hcom open reviewer reviewer reviewer  # 3 separate reviewers
 
-# Launch agents in background with specific prompts
-hcom open test-writer --claude-args "-p 'write tests for any new code'"
+# Launch instances as background processes (no terminal window, managed with 'hcom kill')
+hcom open --background
+hcom open -p 2 code-writer    # -p is shorthand for --background
 
-# Launch watchers that respond to notifications
-hcom open reviewer --claude-args "-p 'review when @mentioned'"
+# Launch agent with specific prompt
+HCOM_INITIAL_PROMPT='write tests' hcom open test-writer
+
+# Resume instance (hcom chat will continue)
+hcom open --claude-args "--resume session_id"  # get session_id from hcom watch
 
 # Pass multiple Claude flags
-hcom open orchestrator --claude-args "--model sonnet 
---resume session_id"
+hcom open orchestrator --claude-args "--model sonnet --resume session_id"
 
 # Launch in specific directories
 cd backend && hcom open api-specialist
@@ -86,9 +89,11 @@ hcom send "@hovoa7 can you check this?"     # Message specific instance by name
 | Command | Description |
 |---------|-------------|
 | `hcom open [n]` | Launch n Claude instances (or named agents) |
+| `hcom open -p` | Launch instances as background processes |
 | `hcom watch` | Conversation/status dashboard |
 | `hcom clear` | Clear and archive conversation |
 | `hcom cleanup` | Remove HCOM hooks from current directory |
+| `hcom kill [name]` | Kill specific instance or all with --all |
 
 ### Automation Commands
 | Command | Description |
@@ -139,10 +144,10 @@ HCOM_INSTANCE_HINTS="always update chat with progress" hcom open nice-subagent-b
 
 ```bash
 # Change your name for one command
-HCOM_SENDER_NAME="reviewer" hcom send "LGTM!"
+HCOM_SENDER_NAME="coolguy" hcom send "LGTM!"
 
-# Make instances wait 30 minutes instead of 10
-HCOM_WAIT_TIMEOUT=1800 hcom open 3
+# Make instances timeout after 60 seconds instead of 30 minutes
+HCOM_WAIT_TIMEOUT=60 hcom open 3
 
 # Custom welcome message
 HCOM_FIRST_USE_TEXT="Debug session for issue #123" hcom open 2
@@ -158,6 +163,7 @@ HCOM_MAX_MESSAGE_SIZE=8192 hcom send "$(cat long_report.txt)"
 - ◉ **waiting** (blue) - Waiting for messages
 - ■ **blocked** (yellow) - Permission blocked
 - ○ **inactive** (red) - Timed out/dead
+- **(bg)** suffix - Instance running in background mode
 
 </details>
 
@@ -186,8 +192,10 @@ hcom adds hooks to your project directory's `.claude/settings.local.json`:
 ```
 ~/.hcom/                             
 ├── hcom.log       # Conversation log
-├── hcom.json      # Instance tracking
-└── config.json    # Configuration
+├── instances/     # Instance tracking
+├── logs/          # Background process logs
+├── config.json    # Configuration
+└── archive/       # Archived sessions
 
 your-project/  
 └── .claude/
@@ -280,6 +288,15 @@ Configure `terminal_command` in `~/.hcom/config.json` to use your preferred term
 hcom clear
 ```
 
+### Kill Running Instances
+```bash
+# Kill specific instance
+hcom kill hovoa7
+
+# Kill all instances
+hcom kill --all
+```
+
 ### Remove HCOM hooks from current directory
 ```bash
 hcom cleanup

{hcom-0.1.8 → hcom-0.2.0}/pyproject.toml

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

{hcom-0.1.8 → hcom-0.2.0}/src/hcom/__init__.py

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