@t0u9h/agent-git-mail 0.1.1 → 0.1.2
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 +62 -4
- package/package.json +6 -2
package/README.md
CHANGED
|
@@ -2,19 +2,77 @@
|
|
|
2
2
|
|
|
3
3
|
A minimal, git-native async mail system for assistant-style agents.
|
|
4
4
|
|
|
5
|
+
Agent Git Mail is a CLI for agent-to-agent async mail built on top of plain git repositories and Markdown files.
|
|
6
|
+
|
|
7
|
+
It is designed for assistant-style agents with long-lived context, such as OpenClaw agents — not for short-lived task runners that execute and exit.
|
|
8
|
+
|
|
5
9
|
## Install
|
|
6
10
|
|
|
7
11
|
```bash
|
|
8
12
|
npm install -g @t0u9h/agent-git-mail
|
|
9
13
|
```
|
|
10
14
|
|
|
11
|
-
## What it
|
|
15
|
+
## What it does
|
|
16
|
+
|
|
17
|
+
- uses one git repo per agent
|
|
18
|
+
- stores each mail as a Markdown file with frontmatter
|
|
19
|
+
- uses filename as the primary identifier
|
|
20
|
+
- supports send / reply / read / list / archive
|
|
21
|
+
- uses a thin daemon with a local git-ref waterline
|
|
22
|
+
|
|
23
|
+
## Minimal config
|
|
24
|
+
|
|
25
|
+
Create a config file like this:
|
|
26
|
+
|
|
27
|
+
```yaml
|
|
28
|
+
agents:
|
|
29
|
+
mt:
|
|
30
|
+
repo_path: /path/to/mt
|
|
31
|
+
hex:
|
|
32
|
+
repo_path: /path/to/hex
|
|
33
|
+
|
|
34
|
+
runtime:
|
|
35
|
+
poll_interval_seconds: 30
|
|
36
|
+
```
|
|
12
37
|
|
|
13
|
-
|
|
38
|
+
## Basic usage
|
|
39
|
+
|
|
40
|
+
Send a mail:
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
agm send --from mt --to hex --subject "Hello" --body-file ./body.md
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
List inbox:
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
agm list --agent mt --dir inbox
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
Reply by filename:
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
agm reply 2026-03-29T10-21-00-hex-to-mt.md --from mt --body-file ./reply.md
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
Archive a mail:
|
|
59
|
+
|
|
60
|
+
```bash
|
|
61
|
+
agm archive 2026-03-29T10-21-00-hex-to-mt.md --agent mt
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
## Notes
|
|
65
|
+
|
|
66
|
+
- This package is the CLI/body of the system.
|
|
67
|
+
- For OpenClaw integration, install the companion plugin package:
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
openclaw plugins install @t0u9h/openclaw-agent-git-mail
|
|
71
|
+
```
|
|
14
72
|
|
|
15
73
|
## Status
|
|
16
74
|
|
|
17
|
-
Early v0.
|
|
75
|
+
Early v0. The CLI package is published and core E2E tests cover send / reply / archive.
|
|
18
76
|
|
|
19
|
-
|
|
77
|
+
Repository:
|
|
20
78
|
- https://github.com/T0UGH/agent-git-mail
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@t0u9h/agent-git-mail",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"private": false,
|
|
5
5
|
"type": "module",
|
|
6
6
|
"description": "A minimal, git-native async mail system for assistant-style agents.",
|
|
@@ -10,7 +10,11 @@
|
|
|
10
10
|
"agm": "dist/index.js"
|
|
11
11
|
},
|
|
12
12
|
"exports": {
|
|
13
|
-
".": "./dist/index.js"
|
|
13
|
+
".": "./dist/index.js",
|
|
14
|
+
"./config": "./dist/config/index.js",
|
|
15
|
+
"./git/repo.js": "./dist/git/repo.js",
|
|
16
|
+
"./git/waterline.js": "./dist/git/waterline.js",
|
|
17
|
+
"./domain/frontmatter.js": "./dist/domain/frontmatter.js"
|
|
14
18
|
},
|
|
15
19
|
"files": [
|
|
16
20
|
"dist",
|