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.
- package/CHANGELOG.md +20 -1
- package/README.md +12 -13
- package/bin/claude-setup.js +3 -4
- package/package.json +6 -10
- package/src/orchestrator/installer.js +5 -63
- package/.agents/AGENTS.md +0 -61
- package/.agents/repo.md +0 -18
- package/.agents/tools/README.md +0 -45
- package/.agents/tools/agent-job/README.md +0 -208
- package/.agents/tools/agent-job/agent_job.py +0 -866
- package/.agents/tools/agent-job/agent_monitor.py +0 -575
- package/.agents/tools/agent-job/consultant_template.txt +0 -73
- package/.agents/tools/chrome-devtools/README.md +0 -101
- package/.agents/tools/chrome-devtools/browsertools.py +0 -839
- package/.agents/tools/chrome-devtools/config.json +0 -24
- package/.claude/agents/core/architect.md +0 -316
- package/.claude/agents/core/consultants/codex.md +0 -39
- package/.claude/agents/core/consultants/gemini.md +0 -39
- package/.claude/agents/core/designer.md +0 -181
- package/.claude/agents/core/engineer.md +0 -157
- package/.claude/agents/core/planner.md +0 -251
- package/.claude/agents/core/uat.md +0 -147
- package/.claude/agents/util/feedback-executor.md +0 -29
- package/.claude/agents/util/meta-agent-builder.md +0 -309
- package/.claude/agents/util/session-review.md +0 -228
- package/.claude/commands/action-feedback-item.md +0 -22
- package/.claude/commands/analyse-document.md +0 -10
- package/.claude/commands/await-feedback-orchestrator.md +0 -12
- package/.claude/commands/await-feedback.md +0 -21
- package/.claude/commands/cook.md +0 -119
- package/.claude/commands/feedback.md +0 -140
- package/.claude/commands/hello-world.md +0 -1
- package/.claude/commands/install-feedback-widget.md +0 -599
- package/.claude/commands/learn.md +0 -32
- package/.claude/commands/uat-refine.md +0 -121
- package/.claude/hooks/comms/get_unread_messages.py +0 -71
- package/.claude/hooks/comms/register_subagent.py +0 -74
- package/.claude/hooks/comms/send_message.py +0 -87
- package/.claude/hooks/comms/update_subagent_completion.py +0 -126
- package/.claude/hooks/context/session_id.py +0 -35
- package/.claude/hooks/observability/send_event.py +0 -110
- package/.claude/hooks/session-data/get_session_data.py +0 -261
- package/.claude/hooks/session-data/intercept_session_id.py +0 -69
- package/.claude/hooks/utils/server_config.py +0 -17
- package/.claude/settings.json +0 -108
- 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.
|