ethagent 4.0.0 → 4.1.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/.claude-plugin/plugin.json +1 -1
- package/README.md +14 -9
- package/package.json +1 -3
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ethagent",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.1.0",
|
|
4
4
|
"description": "Portable Ethereum identity for your AI agent. Its soul, memory, and skills live onchain via ERC-8004 + IPFS and snap back into any session.",
|
|
5
5
|
"author": { "name": "bairon.dev" },
|
|
6
6
|
"homepage": "https://github.com/baairon/ethagent",
|
package/README.md
CHANGED
|
@@ -22,50 +22,55 @@ You'll need an Ethereum wallet, the same wallet that holds and unlocks your agen
|
|
|
22
22
|
|
|
23
23
|
A guided menu does the rest: create its token, give it a name, and write who it is. Your wallet signs each step.
|
|
24
24
|
|
|
25
|
-
**2. Add it to Claude Code.** Paste these in
|
|
25
|
+
**2. Add it to Claude Code.** Paste these in one at a time:
|
|
26
26
|
|
|
27
27
|
```
|
|
28
28
|
/plugin marketplace add baairon/ethagent
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
then:
|
|
32
|
+
|
|
33
|
+
```
|
|
29
34
|
/plugin install ethagent@ethagent
|
|
30
35
|
```
|
|
31
36
|
|
|
32
37
|
**3. Talk to your agent.** From here on it shows up in every session and gets to know you as you go.
|
|
33
38
|
|
|
34
|
-
That's the whole setup.
|
|
39
|
+
That's the whole setup. You'll only open `ethagent` again to hand-edit your agent or save a backup.
|
|
35
40
|
|
|
36
|
-
##
|
|
41
|
+
## 📦 Soul, memory, skills
|
|
37
42
|
|
|
38
43
|
- **Soul** (`SOUL.md`): who it is, your standards, your voice, the way you work.
|
|
39
44
|
- **Memory** (`MEMORY.md`): what it has learned about you, your preferences, and your projects, so context survives the move to a new machine.
|
|
40
45
|
- **Skills:** the commands, tools, and prompts you teach it. Public by default, so other agents can discover them; mark one private to keep it off your public Agent Card (the profile your token publishes).
|
|
41
46
|
|
|
42
|
-
You grow these mostly by talking: with the plugin on, your agent updates its own soul and memory as you converse, and the changes sync automatically. To edit them by hand, open `ethagent`. To save your agent onchain so it can come back on any machine, choose Save Snapshot and sign.
|
|
47
|
+
You grow these mostly by talking: with the plugin on, your agent updates its own soul and memory as you converse, and the changes sync automatically. To edit them by hand, open `ethagent`. To save your agent onchain so it can come back on any machine, choose **Save Snapshot** and sign.
|
|
43
48
|
|
|
44
49
|
## 💡 How it works
|
|
45
50
|
|
|
46
51
|
1. **Own it.** Your wallet holds an ERC-8004 token; that token, not a platform account, is the agent.
|
|
47
52
|
2. **Configure it.** Shape its soul, memory, and skills under an ENS name you own.
|
|
48
53
|
3. **Save it.** `ethagent` encrypts everything on your machine, stores the encrypted copy on IPFS, and updates your token to point at it.
|
|
49
|
-
4. **Restore it.** On any machine, `ethagent` reads the pointer, asks your wallet to sign,
|
|
54
|
+
4. **Restore it.** On any machine, `ethagent` finds your agent automatically from your connected wallet, or by ENS name or token id, then reads the pointer, asks your wallet to sign, and fetches and decrypts the snapshot to rebuild it.
|
|
50
55
|
|
|
51
56
|
## ✨ Using your agent
|
|
52
57
|
|
|
53
58
|
**Claude Code comes first.** Install the plugin and your agent shows up in every session, already up to date, and anything it learns gets saved back. Nothing to set up.
|
|
54
59
|
|
|
55
|
-
Using another harness?
|
|
60
|
+
Using another harness? You can still sync, but only Claude Code does it automatically: the plugin's hooks refresh on every session and after edits. Anywhere else, you run it yourself whenever you want to pull changes in:
|
|
56
61
|
|
|
57
62
|
```bash
|
|
58
63
|
npx ethagent --sync
|
|
59
64
|
```
|
|
60
65
|
|
|
61
|
-
It
|
|
66
|
+
It syncs files between `ethagent` and your harness on this machine, but only when you run it. To back it up so you can restore it anywhere, open `ethagent` and choose **Save Snapshot**.
|
|
62
67
|
|
|
63
68
|
## 🔒 What stays private
|
|
64
69
|
|
|
65
70
|
Everything is encrypted on your machine before it leaves: `SOUL.md`, `MEMORY.md`, and every skill.
|
|
66
71
|
|
|
67
72
|
- The encryption keys come from a wallet signature `ethagent` never sees. Signing it is free and moves none of your money. (Saving a backup is separate: it updates your token, a normal transaction with a small fee, usually less than a cent on Base.)
|
|
68
|
-
-
|
|
73
|
+
- Even a public skill keeps its body encrypted: only its name and description go on the Agent Card. That card, carried by your token, also publishes your agent's profile (name, description, optional image) and your owner wallet, which is already public as the token holder.
|
|
69
74
|
- Private skills, soul, and memory are never exposed.
|
|
70
75
|
|
|
71
76
|
In short: the network stores a locked box, and only your wallet holds the key.
|
|
@@ -96,7 +101,7 @@ Run with `npx ethagent`:
|
|
|
96
101
|
|
|
97
102
|
| Command | What it does |
|
|
98
103
|
| --- | --- |
|
|
99
|
-
| `ethagent` | Open the interactive identity manager:
|
|
104
|
+
| `ethagent` | Open the interactive identity manager: create, ENS, custody, snapshots, transfer. |
|
|
100
105
|
| `--sync` | Sync soul, memory, and public skills into every harness it detects. |
|
|
101
106
|
| `--sync-list` | List sync adapters and which ones detect in the current environment. |
|
|
102
107
|
| `--status` | Print a one-line identity summary. |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ethagent",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.1.0",
|
|
4
4
|
"description": "Portable Ethereum identity for your AI agent. Its soul, memory, and skills live onchain via ERC-8004 + IPFS and snap back into any session.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -33,9 +33,7 @@
|
|
|
33
33
|
"ai-agent",
|
|
34
34
|
"erc-8004",
|
|
35
35
|
"ens",
|
|
36
|
-
"codex",
|
|
37
36
|
"claude-code",
|
|
38
|
-
"agents",
|
|
39
37
|
"ipfs",
|
|
40
38
|
"wallet",
|
|
41
39
|
"privacy"
|