@mkhuda/agent-ps 0.1.0 → 0.2.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 +16 -0
- package/README.md +54 -22
- package/agent-ps +0 -0
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,21 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.2.0
|
|
4
|
+
|
|
5
|
+
Ways to install it, and a release that publishes itself.
|
|
6
|
+
|
|
7
|
+
- `curl | sh` takes the latest release, checks it against the checksum
|
|
8
|
+
published beside it, and makes sure it runs before keeping it.
|
|
9
|
+
- On PyPI as `agent-ps`, so `uvx agent-ps`, `pipx install agent-ps` and
|
|
10
|
+
`pip install agent-ps` all work.
|
|
11
|
+
- On npm as `@mkhuda/agent-ps`, scoped because the plain name is too close to
|
|
12
|
+
an existing package. The command it installs is still `agent-ps`.
|
|
13
|
+
- Releases are built and published from the tag on a clean runner, which
|
|
14
|
+
refuses to start when the tag, the version in the package and this file
|
|
15
|
+
disagree.
|
|
16
|
+
|
|
17
|
+
The tool itself is unchanged.
|
|
18
|
+
|
|
3
19
|
## 0.1.0
|
|
4
20
|
|
|
5
21
|
First public release.
|
package/README.md
CHANGED
|
@@ -3,11 +3,12 @@
|
|
|
3
3
|
A process table for coding agent sessions, the way `ps` would look if it knew
|
|
4
4
|
what a session was.
|
|
5
5
|
|
|
6
|
-
[](https://github.com/mkhuda/agent-ps/actions/workflows/ci.yml)
|
|
7
|
+
[](https://pypi.org/project/agent-ps/)
|
|
8
|
+
[](LICENSE)
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
|
|
11
12
|
|
|
12
13
|
|
|
13
14
|
|
|
@@ -24,16 +25,43 @@ One file, no dependencies, reads local files only.
|
|
|
24
25
|
|
|
25
26
|
## Install
|
|
26
27
|
|
|
28
|
+
### One command
|
|
29
|
+
|
|
27
30
|
```bash
|
|
28
31
|
curl -fsSL https://raw.githubusercontent.com/mkhuda/agent-ps/main/install.sh | sh
|
|
29
32
|
```
|
|
30
33
|
|
|
31
|
-
|
|
32
|
-
makes sure it runs, and
|
|
33
|
-
|
|
34
|
+
Takes the latest release, checks it against the checksum published beside it,
|
|
35
|
+
makes sure it runs, and puts the single file in `~/.local/bin`. Set `BIN_DIR` to
|
|
36
|
+
install elsewhere, or `AGENT_PS_REF=v0.1.0` to pin a version.
|
|
37
|
+
|
|
38
|
+
### With a package runner
|
|
39
|
+
|
|
40
|
+
From [PyPI](https://pypi.org/project/agent-ps/), which installs the program
|
|
41
|
+
itself:
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
uvx agent-ps # run it once
|
|
45
|
+
pipx install agent-ps # keep it, isolated
|
|
46
|
+
pip install agent-ps # keep it, wherever pip points
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
From [npm](https://www.npmjs.com/package/@mkhuda/agent-ps), which carries the
|
|
50
|
+
same single executable and finds an interpreter for it:
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
npx @mkhuda/agent-ps
|
|
54
|
+
pnpm dlx @mkhuda/agent-ps
|
|
55
|
+
bunx @mkhuda/agent-ps
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
The npm package is scoped because the plain name is too close to an existing
|
|
59
|
+
one. Either way the command it gives you is `agent-ps`.
|
|
60
|
+
|
|
61
|
+
### Just the file
|
|
34
62
|
|
|
35
63
|
If you would rather not pipe a script into a shell, the executable is the whole
|
|
36
|
-
program
|
|
64
|
+
program:
|
|
37
65
|
|
|
38
66
|
```bash
|
|
39
67
|
mkdir -p ~/.local/bin
|
|
@@ -43,27 +71,31 @@ chmod +x ~/.local/bin/agent-ps
|
|
|
43
71
|
```
|
|
44
72
|
|
|
45
73
|
Every [release](https://github.com/mkhuda/agent-ps/releases) publishes a
|
|
46
|
-
`SHA256SUMS`
|
|
74
|
+
`SHA256SUMS` next to it.
|
|
47
75
|
|
|
48
|
-
|
|
49
|
-
|
|
76
|
+
### From a clone
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
git clone https://github.com/mkhuda/agent-ps && cd agent-ps
|
|
80
|
+
./install.sh
|
|
81
|
+
```
|
|
50
82
|
|
|
51
|
-
|
|
52
|
-
|
|
83
|
+
Builds from the tree rather than downloading, so you install what you are
|
|
84
|
+
looking at.
|
|
53
85
|
|
|
54
|
-
|
|
55
|
-
3.14. macOS and Linux; Windows is out because `curses` is not in its standard
|
|
56
|
-
library. It shells out to `ps`, and on macOS to `lsof`, which is how a process is
|
|
57
|
-
matched to a session everywhere except Claude Code.
|
|
86
|
+
### What it needs, and how to remove it
|
|
58
87
|
|
|
59
|
-
|
|
88
|
+
Python 3.8 or later and nothing from PyPI. Tested on 3.8, 3.9, 3.10 and 3.14.
|
|
89
|
+
macOS and Linux; Windows is out because `curses` is not in its standard library.
|
|
90
|
+
It shells out to `ps`, and on macOS to `lsof`, which is how a process is matched
|
|
91
|
+
to a session everywhere except Claude Code.
|
|
60
92
|
|
|
61
93
|
```bash
|
|
62
94
|
rm -f ~/.local/bin/agent-ps
|
|
63
95
|
```
|
|
64
96
|
|
|
65
|
-
Nothing is written outside that directory
|
|
66
|
-
own files.
|
|
97
|
+
That is the whole uninstall. Nothing is written outside that directory, and
|
|
98
|
+
agent-ps only ever reads the agents' own files.
|
|
67
99
|
|
|
68
100
|
## Agents
|
|
69
101
|
|
|
@@ -316,7 +348,7 @@ install fetches. The build is reproducible: the same source always produces the
|
|
|
316
348
|
same bytes, so the committed executable can be checked against the tree.
|
|
317
349
|
|
|
318
350
|
```
|
|
319
|
-
|
|
351
|
+
5045dee9f7c0a85a193886e0b5fcf37020a4c36f10537f36fa453d1020aff365 agent-ps
|
|
320
352
|
```
|
|
321
353
|
|
|
322
354
|
Adding an agent takes one class and one line in the registry. See
|
package/agent-ps
CHANGED
|
Binary file
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mkhuda/agent-ps",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "A process table for coding agent sessions. Claude Code, Codex, OpenCode, Hermes, Pi, CommandCode and Copilot in one view, with models, idle time, disk use and one key to stop them.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"cli",
|