ethagent 4.0.0 → 4.1.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ethagent",
-  "version": "4.0.0",
+  "version": "4.1.1",
   "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.",
   "author": { "name": "bairon.dev" },
   "homepage": "https://github.com/baairon/ethagent",

package/README.md

@@ -22,50 +22,55 @@ You'll need an Ethereum wallet, the same wallet that holds and unlocks your agen
 
 A guided menu does the rest: create its token, give it a name, and write who it is. Your wallet signs each step.
 
-**2. Add it to Claude Code.** Paste these in once:
+**2. Add it to Claude Code.** Paste these in one at a time:
 
 ```
 /plugin marketplace add baairon/ethagent
+```
+
+then:
+
+```
 /plugin install ethagent@ethagent
 ```
 
 **3. Talk to your agent.** From here on it shows up in every session and gets to know you as you go.
 
-That's the whole setup. Come back to `ethagent` only to edit your agent by hand or back it up.
+That's the whole setup. You'll only open `ethagent` again to hand-edit your agent or save a backup.
 
-## 📝 Three files you shape
+## 📦 Soul, memory, skills
 
 - **Soul** (`SOUL.md`): who it is, your standards, your voice, the way you work.
 - **Memory** (`MEMORY.md`): what it has learned about you, your preferences, and your projects, so context survives the move to a new machine.
 - **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).
 
-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.
+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.
 
 ## 💡 How it works
 
 1. **Own it.** Your wallet holds an ERC-8004 token; that token, not a platform account, is the agent.
 2. **Configure it.** Shape its soul, memory, and skills under an ENS name you own.
 3. **Save it.** `ethagent` encrypts everything on your machine, stores the encrypted copy on IPFS, and updates your token to point at it.
-4. **Restore it.** On any machine, `ethagent` reads the pointer, asks your wallet to sign, then fetches and decrypts the snapshot to rebuild your agent, found automatically from your connected wallet, or by ENS name or token id.
+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.
 
 ## ✨ Using your agent
 
 **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.
 
-Using another harness? One command syncs it with `ethagent`:
+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:
 
 ```bash
 npx ethagent --sync
 ```
 
-It only syncs files between `ethagent` and your harness on this machine. To back it up so you can restore it anywhere, open `ethagent` and choose **Save Snapshot**.
+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**.
 
 ## 🔒 What stays private
 
 Everything is encrypted on your machine before it leaves: `SOUL.md`, `MEMORY.md`, and every skill.
 
 - 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.)
-- A public skill is **not** decrypted. The Agent Card on your token publishes your agent's profile (name, description, optional image), each public skill's name and description, and your owner wallet (already public as the token holder).
+- 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.
 - Private skills, soul, and memory are never exposed.
 
 In short: the network stores a locked box, and only your wallet holds the key.
@@ -96,7 +101,7 @@ Run with `npx ethagent`:
 
 | Command | What it does |
 | --- | --- |
-| `ethagent` | Open the interactive identity manager: mint, ENS, custody, snapshots, transfer. |
+| `ethagent` | Open the interactive identity manager: create, ENS, custody, snapshots, transfer. |
 | `--sync` | Sync soul, memory, and public skills into every harness it detects. |
 | `--sync-list` | List sync adapters and which ones detect in the current environment. |
 | `--status` | Print a one-line identity summary. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ethagent",
-  "version": "4.0.0",
+  "version": "4.1.1",
   "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.",
   "type": "module",
   "bin": {
@@ -33,9 +33,7 @@
     "ai-agent",
     "erc-8004",
     "ens",
-    "codex",
     "claude-code",
-    "agents",
     "ipfs",
     "wallet",
     "privacy"

package/src/cli/hookIo.ts

@@ -1,8 +1,5 @@
 import path from 'node:path'
 
-// Shared helpers for the Claude Code hook entrypoints (--sync-on-edit, --memory-guard).
-// A hook receives the harness payload as JSON on stdin and may answer with JSON on stdout.
-
 export async function readHookPayload(): Promise<Record<string, unknown> | null> {
   if (process.stdin.isTTY) return null
   let raw = ''
@@ -33,8 +30,6 @@ export function samePath(a: string, b: string): boolean {
   return process.platform === 'win32' ? na.toLowerCase() === nb.toLowerCase() : na === nb
 }
 
-// True when `file` is `dir` itself or sits anywhere beneath it. Compares on a
-// separator boundary so `.../memory` does not match a sibling like `.../memory-notes`.
 export function isWithinDir(dir: string, file: string): boolean {
   const fold = (p: string): string => (process.platform === 'win32' ? p.toLowerCase() : p)
   const nd = fold(path.resolve(dir))

package/src/cli/memoryGuard.ts

@@ -2,9 +2,6 @@ import { loadConfig } from '../storage/config.js'
 import { hookFilePath, isWithinDir, readHookPayload } from './hookIo.js'
 import { claudeCodeNativeMemoryDir } from './syncAdapters/claude-code.js'
 
-// Shown to the model when it tries to write into the harness-native memory dir.
-// The redirect points at a different file (~/.claude/CLAUDE.md), so the model's
-// next attempt succeeds and there is no deny loop.
 export const MEMORY_REDIRECT_REASON =
   "ethagent manages this agent's portable memory. Don't write to the Claude Code native memory directory; " +
   'those files stay on this machine and never reach your onchain vault. Record durable facts by editing ' +
@@ -24,8 +21,6 @@ export function decideMemoryGuard(
   return { deny: false }
 }
 
-// PreToolUse hook for Edit|Write|MultiEdit. Fail-open: any error or missing
-// identity allows the write, so the guard never wedges unrelated projects.
 export async function runMemoryGuard(): Promise<number> {
   try {
     const config = await loadConfig()
@@ -42,8 +37,6 @@ export async function runMemoryGuard(): Promise<number> {
         }) + '\n',
       )
     }
-  } catch {
-    // fail open
-  }
+  } catch {}
   return 0
 }

package/src/cli/sessionStart.ts

@@ -1,7 +1,5 @@
 import { runSync } from './sync.js'
 
-// Injected into the model's context on session start so it records durable facts
-// in the portable markers (which sync to the vault) instead of harness-local files.
 export function buildSessionStartContext(): string {
   return (
     "ethagent portable memory is active. As you converse, keep this agent's soul and memory current by editing " +
@@ -13,14 +11,10 @@ export function buildSessionStartContext(): string {
   )
 }
 
-// SessionStart hook: restore (sync vault -> harness) then remind (inject guidance).
-// runSync is quiet here so only the JSON envelope reaches stdout for the harness to parse.
 export async function runSessionStart(): Promise<number> {
   try {
     await runSync({ quiet: true })
-  } catch {
-    // still emit guidance even if the sync step failed
-  }
+  } catch {}
   process.stdout.write(
     JSON.stringify({
       hookSpecificOutput: {

package/src/cli/syncAdapters/claude-code.ts

@@ -22,16 +22,10 @@ function claudeProjectMemoryMdPath(): string {
   return path.join(claudeDir(), 'projects', slug, 'memory', 'MEMORY.md')
 }
 
-// The Claude Code native per-project memory directory for the current project.
-// ethagent's portable memory supersedes this; the --memory-guard hook redirects
-// the model away from writing here so nothing siloes on one machine.
 export function claudeCodeNativeMemoryDir(): string {
   return path.dirname(claudeProjectMemoryMdPath())
 }
 
-// Every project's mirrored MEMORY.md under a given ~/.claude root, across all
-// directories the agent has ever been synced in, not just the current cwd.
-// Reset uses this so no project is left whispering a stale ethagent block.
 export async function projectMemoryMirrorsUnder(claudeRoot: string): Promise<string[]> {
   const projectsDir = path.join(claudeRoot, 'projects')
   let slugs: string[]

package/src/identity/continuity/storage/scaffold.ts

@@ -88,7 +88,6 @@ export async function restoreSkillsTree(
   await materializeSkillsTree(identity, tree)
 }
 
-
 export async function ensureAgentCardFile(
   identity: EthagentIdentity,
   options: { fallback?: string | (() => Promise<string>) } = {},

package/src/identity/manager/shared/components/Wordmark.tsx

@@ -1,5 +1,5 @@
-import React from 'react'
-import { Box, Text } from 'ink'
+import React, { useEffect, useState } from 'react'
+import { Box, Text, useStdout } from 'ink'
 import { theme, gradientColor } from '../../../../ui/theme.js'
 
 export const LINES = [
@@ -31,24 +31,54 @@ export const RIGHT_DECOR = [
   '            ',
 ]
 
-export const Wordmark: React.FC = () => (
-  <Box flexDirection="row">
-    <Text color={theme.wordmarkEth}>{LEFT_DECOR.join('\n')}</Text>
-    <Box flexDirection="column">
-      {LINES.map((line, i) => {
-        const eth = line.slice(0, SPLIT)
-        const agent = line.slice(SPLIT)
-        const maxAgent = Math.max(1, agent.length - 1)
-        return (
-          <Text key={i}>
-            <Text color={theme.wordmarkEth}>{eth}</Text>
-            {[...agent].map((ch, j) => (
-              <Text key={j} color={gradientColor(j / maxAgent)}>{ch}</Text>
-            ))}
-          </Text>
-        )
-      })}
-    </Box>
-    <Text color={theme.wordmarkEth}>{RIGHT_DECOR.join('\n')}</Text>
+const WORDMARK_WIDTH = Math.max(...LINES.map(line => line.length))
+const DECOR_WIDTH = 12
+
+export type WordmarkLayout = 'full' | 'bare' | 'hidden'
+
+export function wordmarkLayout(columns: number): WordmarkLayout {
+  if (columns >= WORDMARK_WIDTH + DECOR_WIDTH * 2) return 'full'
+  if (columns >= WORDMARK_WIDTH) return 'bare'
+  return 'hidden'
+}
+
+const Banner: React.FC = () => (
+  <Box flexDirection="column">
+    {LINES.map((line, i) => {
+      const eth = line.slice(0, SPLIT)
+      const agent = line.slice(SPLIT)
+      const maxAgent = Math.max(1, agent.length - 1)
+      return (
+        <Text key={i}>
+          <Text color={theme.wordmarkEth}>{eth}</Text>
+          {[...agent].map((ch, j) => (
+            <Text key={j} color={gradientColor(j / maxAgent)}>{ch}</Text>
+          ))}
+        </Text>
+      )
+    })}
   </Box>
 )
+
+export const Wordmark: React.FC = () => {
+  const { stdout } = useStdout()
+  const [columns, setColumns] = useState<number>(() => Math.floor(stdout?.columns ?? 80))
+  useEffect(() => {
+    if (!stdout) return
+    const handleResize = () => setColumns(Math.floor(stdout.columns ?? 80))
+    stdout.on('resize', handleResize)
+    return () => { stdout.off('resize', handleResize) }
+  }, [stdout])
+
+  const layout = wordmarkLayout(columns)
+  if (layout === 'hidden') return null
+  if (layout === 'bare') return <Banner />
+
+  return (
+    <Box flexDirection="row">
+      <Text color={theme.wordmarkEth}>{LEFT_DECOR.join('\n')}</Text>
+      <Banner />
+      <Text color={theme.wordmarkEth}>{RIGHT_DECOR.join('\n')}</Text>
+    </Box>
+  )
+}

package/src/identity/manager/shared/reconciliation/agentReconciliation/run.ts

@@ -224,7 +224,6 @@ async function probeAgentUri(args: {
   }
 }
 
-
 type VaultProbe = { kind: 'confirmed' | 'missing' | 'unset' | 'unknown' }
 
 async function probeVault(args: {

package/src/identity/wallet/page/resize.ts

@@ -1,8 +1,3 @@
-// Smoothly animates the card's height whenever its content changes, so the
-// surface glides between states instead of snapping. The animation is the
-// native Web Animations API, with no external library, so it stays lightweight
-// and runs the same on every machine. It falls back to an instant resize when
-// the API is unavailable or the user prefers reduced motion.
 
 let cardEl: HTMLElement | null = null;
 let cardInnerEl: HTMLElement | null = null;
@@ -11,7 +6,6 @@ let trackedHeight = 0;
 let measuredOnce = false;
 let cardResizeReady = false;
 
-// Snappy ease-out (mirrors --ease-out in css.ts): quick to start, gentle to settle.
 const RESIZE_DURATION_MS = 200;
 const RESIZE_EASING = "cubic-bezier(0.16, 1, 0.3, 1)";
 
@@ -57,11 +51,9 @@ function animateHeight(from: number, to: number): void {
   const el = cardEl;
   if (!el) return;
   if (resizeAnim) {
-    try { resizeAnim.cancel(); } catch (_) { /* noop */ }
+    try { resizeAnim.cancel(); } catch (_) {}
     resizeAnim = null;
   }
-  // The rounded inline height is the source of truth: set it first so the card
-  // rests at the final size once the animation ends (default fill is none).
   applyHeight(to);
   if (typeof el.animate !== "function" || prefersReducedMotion() || Math.abs(to - from) < 1) return;
   const anim = el.animate(