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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hcom
-Version: 0.1.7
+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 claude-3-opus 
---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.2.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+hcom/__init__.py,sha256=OTLgmiORAs0PeavpKv2TStEiSchd2KDp4ZCGzWNWsAs,96
+hcom/__main__.py,sha256=CdWcj4qvpDjFELcShpKZQ30RTVQxE2AdCDPd83pwD2c,93850
+hcom-0.2.0.dist-info/METADATA,sha256=ZPianbn_y61bLc-mW3htCOPryQg_EJZi15Xs9y8a93k,10934
+hcom-0.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+hcom-0.2.0.dist-info/entry_points.txt,sha256=cz9K9PsgYmORUxNKxVRrpxLS3cxRJcDZkE-PpfvOhI8,44
+hcom-0.2.0.dist-info/top_level.txt,sha256=8AS1nVUWA26vxjDQ5viRxgJnwSvUWk1W6GP4g6ldZ-0,5
+hcom-0.2.0.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,,