agentwatch-tool 0.1.2 → 0.1.4
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/README.md +74 -0
- package/package.json +5 -5
package/README.md
ADDED
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# agentwatch-tool
|
|
2
|
+
|
|
3
|
+
Wrap any terminal agent or script — get a push notification or email on your
|
|
4
|
+
phone when it finishes, fails, stalls, hits a timeout, or needs a decision.
|
|
5
|
+
|
|
6
|
+
Works with any agentic tool — Claude Code, Codex, Copilot, Cursor, Devin,
|
|
7
|
+
Aider, custom scripts — anything that can run shell commands.
|
|
8
|
+
|
|
9
|
+
## Install
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
npm i -g agentwatch-tool # or: npx agentwatch-tool <command>
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Prebuilt binaries for macOS (arm64/x64) and Linux (x64/arm64) — no Python or
|
|
16
|
+
build step required.
|
|
17
|
+
|
|
18
|
+
## Setup (once)
|
|
19
|
+
|
|
20
|
+
```sh
|
|
21
|
+
agentwatch login # prints a link — sign in + approve in the PWA
|
|
22
|
+
agentwatch install-service # background daemon (or run `agentwatch daemon`)
|
|
23
|
+
agentwatch init # seeds AGENTS.md so agents discover the tool
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
The dashboard is hosted at https://agentwatch-web-ten.vercel.app — sign in
|
|
27
|
+
there on your phone, allow notifications, and flip **Phone alerts** on.
|
|
28
|
+
|
|
29
|
+
## Use it
|
|
30
|
+
|
|
31
|
+
```sh
|
|
32
|
+
agentwatch run --name build -- npm run build # wraps any command
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
- exit 0 → `done`, non-zero → `failed`, deadline → `timed_out`, silence → `stalled`
|
|
36
|
+
- events queue locally when offline and flush on reconnect
|
|
37
|
+
|
|
38
|
+
Inside agents and scripts:
|
|
39
|
+
|
|
40
|
+
```sh
|
|
41
|
+
agentwatch ask "Deploy to prod or staging?" # blocking question → your phone
|
|
42
|
+
agentwatch done "Migrated 42 models." # completion → your phone
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
`agentwatch init` writes the instruction block into `AGENTS.md` (read by most
|
|
46
|
+
agentic tools). Add `--agents copilot,claude,gemini` for tool-specific files,
|
|
47
|
+
or `--global` to apply it to every repo on the machine
|
|
48
|
+
(`~/.claude/CLAUDE.md`, `~/.codex/AGENTS.md`, `~/.gemini/GEMINI.md`).
|
|
49
|
+
|
|
50
|
+
## Commands
|
|
51
|
+
|
|
52
|
+
| Command | Purpose |
|
|
53
|
+
|---|---|
|
|
54
|
+
| `agentwatch login` / `logout` | enroll / revoke this machine |
|
|
55
|
+
| `agentwatch run --name N -- cmd` | wrap a command, report lifecycle |
|
|
56
|
+
| `agentwatch ask` / `done` | signal from inside an agent or script |
|
|
57
|
+
| `agentwatch init` | seed instruction files for agentic tools |
|
|
58
|
+
| `agentwatch daemon` / `install-service` | delivery + heartbeat daemon |
|
|
59
|
+
| `agentwatch privacy [full\|metadata]` | what leaves the machine |
|
|
60
|
+
| `agentwatch status` | local state |
|
|
61
|
+
| `agentwatch test` | one event of each type |
|
|
62
|
+
|
|
63
|
+
## Privacy
|
|
64
|
+
|
|
65
|
+
Events carry only a one-line redacted summary — never the command line or
|
|
66
|
+
output. `metadata` mode replaces summaries with fixed labels
|
|
67
|
+
(`Question from {agent}`, `Task finished`) so nothing about the work leaves
|
|
68
|
+
the machine. Redaction happens locally before anything is queued.
|
|
69
|
+
|
|
70
|
+
## Links
|
|
71
|
+
|
|
72
|
+
- Repo + spec: https://github.com/NivedGanga/watcher
|
|
73
|
+
- Web PWA: https://agentwatch-web-ten.vercel.app
|
|
74
|
+
- Release notes: https://github.com/NivedGanga/watcher/releases
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agentwatch-tool",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.4",
|
|
4
4
|
"description": "Wrap terminal agents and get push/email alerts on completion, failure, questions, timeouts, and stalls.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
6
|
"keywords": ["agent", "monitoring", "alerts", "cli", "devtools"],
|
|
@@ -13,10 +13,10 @@
|
|
|
13
13
|
"node": ">=16"
|
|
14
14
|
},
|
|
15
15
|
"optionalDependencies": {
|
|
16
|
-
"agentwatch-tool-darwin-arm64": "0.1.
|
|
17
|
-
"agentwatch-tool-darwin-x64": "0.1.
|
|
18
|
-
"agentwatch-tool-linux-x64": "0.1.
|
|
19
|
-
"agentwatch-tool-linux-arm64": "0.1.
|
|
16
|
+
"agentwatch-tool-darwin-arm64": "0.1.4",
|
|
17
|
+
"agentwatch-tool-darwin-x64": "0.1.4",
|
|
18
|
+
"agentwatch-tool-linux-x64": "0.1.4",
|
|
19
|
+
"agentwatch-tool-linux-arm64": "0.1.4"
|
|
20
20
|
},
|
|
21
21
|
"repository": {
|
|
22
22
|
"type": "git",
|