nosleepp 0.2.0 → 0.2.1
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 +98 -0
- package/package.json +3 -1
package/README.md
ADDED
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
# nosleepp
|
|
2
|
+
|
|
3
|
+
Keep your computer awake while AI agents are actively working.
|
|
4
|
+
|
|
5
|
+
`nosleepp` is built for agent tools such as Codex, Claude Code, OpenCode, Antigravity, and Cursor. It does not treat an app as working just because it is open. It samples process activity and only reports agents that show measurable CPU or child-process activity.
|
|
6
|
+
|
|
7
|
+
## Install Globally
|
|
8
|
+
|
|
9
|
+
Install it globally so the `nosleepp` command is available from any terminal:
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
npm install -g nosleepp
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
Then run:
|
|
16
|
+
|
|
17
|
+
```bash
|
|
18
|
+
nosleepp watch
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
## Quick Start
|
|
22
|
+
|
|
23
|
+
Check whether any agent is actively working:
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
nosleepp list
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Keep your computer awake while agents are working:
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
nosleepp watch
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
Show matching agents even when they are open but idle:
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
nosleepp list --all
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
Check once and exit with a script-friendly status code:
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
nosleepp watch --once
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## Supported Platforms
|
|
48
|
+
|
|
49
|
+
| Platform | Status |
|
|
50
|
+
| --- | --- |
|
|
51
|
+
| Windows x64 | Supported |
|
|
52
|
+
| macOS Apple Silicon | Supported |
|
|
53
|
+
| macOS Intel | Supported |
|
|
54
|
+
| Linux | Not supported yet |
|
|
55
|
+
|
|
56
|
+
`nosleepp` prevents system idle sleep. It does not force your display to stay awake.
|
|
57
|
+
|
|
58
|
+
## How It Detects Work
|
|
59
|
+
|
|
60
|
+
`nosleepp` samples running processes for 2 seconds by default.
|
|
61
|
+
|
|
62
|
+
An agent is marked `working` when either:
|
|
63
|
+
|
|
64
|
+
- the agent process or one of its descendant processes gains enough CPU time, or
|
|
65
|
+
- a descendant process appears or disappears during the sample window.
|
|
66
|
+
|
|
67
|
+
If an agent app is open but idle, `nosleepp list` hides it by default. Use `nosleepp list --all` to show idle matches too.
|
|
68
|
+
|
|
69
|
+
## Useful Commands
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
nosleepp list
|
|
73
|
+
nosleepp list --json
|
|
74
|
+
nosleepp list --all
|
|
75
|
+
nosleepp watch
|
|
76
|
+
nosleepp watch --interval 5s
|
|
77
|
+
nosleepp watch --quiet 1m
|
|
78
|
+
nosleepp version
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
## Add Custom Agents
|
|
82
|
+
|
|
83
|
+
Use `--agent` to add or override process names:
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
nosleepp watch --agent "MyAgent=myagent,myagent-helper"
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
You can pass `--agent` more than once.
|
|
90
|
+
|
|
91
|
+
## Exit Codes
|
|
92
|
+
|
|
93
|
+
| Code | Meaning |
|
|
94
|
+
| --- | --- |
|
|
95
|
+
| `0` | Success, or `watch --once` found a working agent |
|
|
96
|
+
| `1` | `watch --once` found no working agents |
|
|
97
|
+
| `2` | Invalid CLI usage |
|
|
98
|
+
| `3` | Platform power-state or watcher runtime error |
|
package/package.json
CHANGED
|
@@ -1,11 +1,13 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "nosleepp",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"description": "Keep your PC awake while AI agents are working",
|
|
5
|
+
"preferGlobal": true,
|
|
5
6
|
"bin": {
|
|
6
7
|
"nosleepp": "./index.js"
|
|
7
8
|
},
|
|
8
9
|
"files": [
|
|
10
|
+
"README.md",
|
|
9
11
|
"index.js",
|
|
10
12
|
"lib/resolve-binary.js",
|
|
11
13
|
"bin/nosleepp-win32-x64.exe",
|