claude-comms 1.0.45 → 2.0.0

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.
Files changed (46) hide show
  1. package/CHANGELOG.md +20 -1
  2. package/README.md +12 -13
  3. package/bin/claude-setup.js +3 -4
  4. package/package.json +6 -10
  5. package/src/orchestrator/installer.js +5 -63
  6. package/.agents/AGENTS.md +0 -61
  7. package/.agents/repo.md +0 -18
  8. package/.agents/tools/README.md +0 -45
  9. package/.agents/tools/agent-job/README.md +0 -208
  10. package/.agents/tools/agent-job/agent_job.py +0 -866
  11. package/.agents/tools/agent-job/agent_monitor.py +0 -575
  12. package/.agents/tools/agent-job/consultant_template.txt +0 -73
  13. package/.agents/tools/chrome-devtools/README.md +0 -101
  14. package/.agents/tools/chrome-devtools/browsertools.py +0 -839
  15. package/.agents/tools/chrome-devtools/config.json +0 -24
  16. package/.claude/agents/core/architect.md +0 -316
  17. package/.claude/agents/core/consultants/codex.md +0 -39
  18. package/.claude/agents/core/consultants/gemini.md +0 -39
  19. package/.claude/agents/core/designer.md +0 -181
  20. package/.claude/agents/core/engineer.md +0 -157
  21. package/.claude/agents/core/planner.md +0 -251
  22. package/.claude/agents/core/uat.md +0 -147
  23. package/.claude/agents/util/feedback-executor.md +0 -29
  24. package/.claude/agents/util/meta-agent-builder.md +0 -309
  25. package/.claude/agents/util/session-review.md +0 -228
  26. package/.claude/commands/action-feedback-item.md +0 -22
  27. package/.claude/commands/analyse-document.md +0 -10
  28. package/.claude/commands/await-feedback-orchestrator.md +0 -12
  29. package/.claude/commands/await-feedback.md +0 -21
  30. package/.claude/commands/cook.md +0 -119
  31. package/.claude/commands/feedback.md +0 -140
  32. package/.claude/commands/hello-world.md +0 -1
  33. package/.claude/commands/install-feedback-widget.md +0 -599
  34. package/.claude/commands/learn.md +0 -32
  35. package/.claude/commands/uat-refine.md +0 -121
  36. package/.claude/hooks/comms/get_unread_messages.py +0 -71
  37. package/.claude/hooks/comms/register_subagent.py +0 -74
  38. package/.claude/hooks/comms/send_message.py +0 -87
  39. package/.claude/hooks/comms/update_subagent_completion.py +0 -126
  40. package/.claude/hooks/context/session_id.py +0 -35
  41. package/.claude/hooks/observability/send_event.py +0 -110
  42. package/.claude/hooks/session-data/get_session_data.py +0 -261
  43. package/.claude/hooks/session-data/intercept_session_id.py +0 -69
  44. package/.claude/hooks/utils/server_config.py +0 -17
  45. package/.claude/settings.json +0 -108
  46. package/CLAUDE.md +0 -240
@@ -1,101 +0,0 @@
1
- # Chrome DevTools Browser Automation Tool
2
-
3
- Stateful Chrome automation wrapper that reduces context token usage by 96% while maintaining full browser state across multiple CLI invocations.
4
-
5
- ## Quick Start
6
-
7
- ```bash
8
- # From repo root - start daemon in background
9
- uv run .agents/tools/chrome-devtools/browsertools.py daemon start &
10
- sleep 5
11
-
12
- # Use commands - state persists across invocations!
13
- uv run .agents/tools/chrome-devtools/browsertools.py nav http://localhost:5173/
14
- uv run .agents/tools/chrome-devtools/browsertools.py snap
15
- uv run .agents/tools/chrome-devtools/browsertools.py click 1_7
16
- uv run .agents/tools/chrome-devtools/browsertools.py snap
17
-
18
- # Stop when done
19
- uv run .agents/tools/chrome-devtools/browsertools.py daemon stop
20
- ```
21
-
22
- ## Full Command Reference
23
-
24
- Run `uv run .agents/tools/chrome-devtools/browsertools.py --help` to see all commands.
25
-
26
- **Key commands:**
27
- - `daemon start` - Start browser (run in background with `&`)
28
- - `nav <url>` - Navigate to URL
29
- - `snap` - Get page snapshot with element UIDs
30
- - `click <uid>` - Click element
31
- - `fill <uid> <value>` - Fill input/select
32
- - `shot [path]` - Screenshot
33
- - `conslist`, `netlist` - Debug console/network
34
- - `daemon stop` - Clean shutdown
35
-
36
- ## Configuration
37
-
38
- **Default:** Headless mode (no Chrome window)
39
-
40
- **To use visual mode:** Create `~/.browsertools/config.json`:
41
- ```json
42
- {
43
- "mcp_args": ["-y", "chrome-devtools-mcp@latest", "--isolated"]
44
- }
45
- ```
46
-
47
- **For sandbox:** See `config.json` in this directory for examples.
48
-
49
- ## Architecture
50
-
51
- - **Persistent daemon** - Single MCP server runs in background
52
- - **Unix socket bridge** - Multiple CLI commands share state via socket
53
- - **Stateful** - Snapshots, tabs, cookies persist across invocations
54
- - **Clean shutdown** - Process groups ensure no orphaned Chrome processes
55
-
56
-
57
- ## Complete UAT Example
58
-
59
- ```bash
60
- # Start daemon
61
- uv run .agents/tools/chrome-devtools/browsertools.py daemon start &
62
- sleep 5
63
-
64
- # Navigate and get page structure
65
- uv run .agents/tools/chrome-devtools/browsertools.py nav http://app.com/login
66
- uv run .agents/tools/chrome-devtools/browsertools.py snap | grep email
67
- # Found: uid=1_23 input "email"
68
-
69
- # Fill form
70
- uv run .agents/tools/chrome-devtools/browsertools.py fill 1_23 user@example.com
71
- uv run .agents/tools/chrome-devtools/browsertools.py fill 1_24 password
72
- uv run .agents/tools/chrome-devtools/browsertools.py click 1_25
73
-
74
- # Verify
75
- uv run .agents/tools/chrome-devtools/browsertools.py wait "Dashboard"
76
- uv run .agents/tools/chrome-devtools/browsertools.py conslist --types error
77
- uv run .agents/tools/chrome-devtools/browsertools.py shot /tmp/success.png
78
-
79
- # Cleanup
80
- uv run .agents/tools/chrome-devtools/browsertools.py daemon stop
81
- ```
82
-
83
- ## Troubleshooting
84
-
85
- **Chrome window appears:** Remove `~/.browsertools/config.json` to use default headless mode
86
-
87
- **"Daemon not running":**
88
- ```bash
89
- uv run .agents/tools/chrome-devtools/browsertools.py daemon status
90
- uv run .agents/tools/chrome-devtools/browsertools.py daemon start &
91
- ```
92
-
93
- **Timeouts:** Increase with `--timeout` flag on nav/wait commands
94
-
95
- ## Files
96
-
97
- - `browsertools.py` - Main tool (24KB)
98
- - `config.json` - Default config (headless mode)
99
- - `README.md` - This file
100
-
101
- User config at `~/.browsertools/config.json` overrides repo defaults.