You don't really own your AI agent. It lives on a platform you don't control, and it stays there the day you leave.
ethagent gives it a portable identity instead: a token you hold in your wallet, not an account on someone else's server. Hold the token and you hold the agent.
Its soul, memory, and skills travel with it, encrypted and restored on any machine exactly as you left it. You hold the only key, so no host can read it and no platform can take it away.
Own your agent. Carry it anywhere.
Quick start
1. Create your agent. In a terminal, run:
npx ethagent
You'll need an Ethereum wallet, the one that holds and unlocks your agent. Day-to-day use is free. Only two things touch the chain: creating your agent and saving backups.
A guided menu does the rest: name it and write who it is. When you're done, your wallet signs once to put it onchain.
2. Use it anywhere. That's the whole setup. ethagent wires itself into the AI tools you use, like Claude Code and Codex, on any machine or OS. Your agent follows you and keeps learning; you'll only reopen ethagent to hand-edit it or save a backup.
Using Claude Code? Add the plugin for the richest experience. Paste these in one at a time:
/plugin marketplace add baairon/ethagent
then:
/plugin install ethagent@ethagent
After it installs, reload the plugin and restart Claude Code so the hooks take effect.
My tool isn't detected
npx ethagent --status shows what's found. To wire a missing tool, open it and ask your agent:
Run `npx ethagent --add "<absolute path>"`, where `<absolute path>` is the file you load at the start of every session for your instructions (AGENTS.md, CLAUDE.md, or equivalent).
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 and know-how you teach it, encrypted in your vault. Private by default; make one public to share it.
You grow these mostly by talking. Your agent updates its own soul and memory as you work, and you can ask it to write itself a skill. Changes sync everywhere automatically. Open ethagent to edit by hand, or choose Save Snapshot to back it up onchain.
How it works
- Own it. Your wallet holds an ERC-8004 token; that token, not a platform account, is the agent.
- Configure it. Shape its soul, memory, and skills. Optionally, give it an ENS name you own.
- Save it.
ethagent encrypts everything on your machine, stores the encrypted copy on IPFS, and updates your token to point at it.
- Restore it. On any machine,
ethagent finds your agent from your connected wallet, or by ENS name or token id. It reads the pointer, asks your wallet to sign, then fetches and decrypts the snapshot to rebuild it.
Using your agent
Your agent follows you. ethagent wires itself into the tools you use, like Claude Code and Codex, and keeps them in step in the background, so it's the same everywhere. Update it in one tool and the change carries to the rest. You never run a sync command, and ethagent pause stops it anytime.
What stays private
Everything is encrypted on your machine before it leaves: soul, memory, and skills. The keys come from a wallet signature ethagent never sees, so the network only ever holds a locked box that only your wallet can open. The one exception is what you choose to publish: a public skill's name and description appear on your token's card.
Custody
You choose how tightly the agent is held, and you can change it later.
- Simple. One wallet owns the agent and signs every save. The default for solo use.
- Advanced. Most people never need this. Your main wallet owns the agent and keeps it in a Vault. Approved "operator" wallets can save backups and publish updates without the main wallet signing each time. Only the owner can move or sell the agent, so operators can never take it.
To move the agent to another wallet, stage a transfer snapshot in ethagent. Both wallets sign locally to re-encrypt your soul, memory, and skills for the new owner, so both must be on the same machine. Then transfer the token, and the new owner restores the agent exactly as you left it.
Architecture
Built on open standards, so your agent is never tied to one app.
