ethagent 1.1.0 → 1.1.2

package/README.md

@@ -3,118 +3,61 @@
 
 A privacy-first AI agent with a portable Ethereum identity.
 
-ethagent is a terminal agent for coding and project work. It gives the agent a wallet-owned ERC-8004 identity, keeps private continuity encrypted, and publishes public capability metadata as structured JSON so other applications and agents can understand what it can do.
-
-The identity stays portable. The model can change. The private memory stays under wallet-gated encryption.
+ethagent binds an AI agent to a wallet-owned ERC-8004 token. Persona and memory stay encrypted under your wallet signature and pinned to IPFS. Public skills publish as machine-readable JSON so other agents can discover what it does. Swap models, switch machines, restore the same agent from one onchain pointer.
 
 ## Install
 
 ethagent requires Node.js 20 or newer. Install it from npm with `npm install -g ethagent`, then start it with `ethagent`.
 
-On first run, ethagent guides you through model setup and identity setup. You can use a local GGUF model through llama.cpp, or connect OpenAI, Anthropic, or Gemini.
-
-## What It Does
-
-* Runs an AI coding agent in your terminal.
-* Switches between cloud models and local GGUF models.
-* Creates or loads a wallet-owned ERC-8004 agent identity.
-* Encrypts private continuity before IPFS pinning.
-* Publishes public `skills.json` and Agent Card metadata for discovery.
-* Restores the same agent on another machine from the onchain record.
-* Supports workspace tools, managed edit rewind, session resume, context compaction, and MCP servers.
-
 ## First Run
 
-Start with `ethagent`. The setup flow asks for a model path first, then offers identity setup.
-
-You can create a new ERC-8004 agent with a browser wallet, load an agent token you already own, or skip identity setup and add it later from the Identity Hub.
-
-Use `Alt+P` to switch models and `Alt+I` to open the Identity Hub. Inside the agent, `/help` shows the live command list for the version you are running.
+First run walks identity setup, then model setup. You can use a local GGUF model through llama.cpp, or connect OpenAI, Anthropic, or Gemini.
 
-## Identity Hub
+Create a new ERC-8004 agent with a browser wallet, load an agent token you already own, or skip identity setup and add it later from the Identity Hub.
 
-The Identity Hub is where the portable identity is managed.
+Use `Alt+P` to swap models and `Alt+I` to open the Identity Hub. Inside the agent, `/help` shows the live command list for the version you are running.
 
-| Area | What It Controls |
-| --- | --- |
-| Public Metadata | Profile name, description, image, `skills.json`, and Agent Card. |
-| Private Local Files | `SOUL.md`, `MEMORY.md`, and the local copy of `skills.json`. |
-| Recovery | Publishing the current encrypted snapshot or refetching the latest one from chain. |
-| Storage | The Pinata JWT used to pin continuity and metadata to IPFS. |
-| Agent Token | Registry, owner, token, URI, CID, and copyable identity values. |
-
-The hub is a recovery panel, not a history archive. The current tokenURI is the source of truth for the latest published state.
-
-## Continuity
+## Identity & Continuity
 
-Each identity gets a local continuity vault under `~/.ethagent/continuity`.
+The Identity Hub manages the portable identity. Each identity gets a local continuity vault under `~/.ethagent/continuity`.
 
 | File | Visibility | Purpose |
 | --- | --- | --- |
 | `SOUL.md` | Private | Persona, boundaries, standing instructions, and identity framing. |
 | `MEMORY.md` | Private | Durable preferences, project context, decisions, and operating notes. |
-| `skills.json` | Public | Machine-readable capabilities, input modes, output modes, and discovery metadata. |
-
-`SOUL.md` and `MEMORY.md` are encrypted before they are pinned to IPFS. They are not published as plaintext in token metadata.
-
-`skills.json` is public by design. It uses schema `ethagent.public-skills.v1` and is meant to be easy for other agents, apps, and scanners to parse.
-
-## Recovery
+| `skills.json` | Public | Machine-readable capabilities under schema `ethagent.public-skills.v1`, easy for other agents and apps to parse. |
 
-**Publish Snapshot Now** encrypts the current private continuity, pins the public discovery files, writes current registration metadata, and updates the ERC-8004 tokenURI.
+`SOUL.md` and `MEMORY.md` are encrypted before they reach IPFS. They are never published as plaintext in token metadata.
 
-**Refetch Latest Snapshot** reads the current tokenURI from chain, downloads the encrypted continuity envelope, asks the owner wallet to sign the decrypt challenge, and restores local continuity files from the published state.
+**Save Snapshot Now** encrypts the current private continuity, pins the public discovery files, writes registration metadata, and updates the ERC-8004 tokenURI. **Refetch Latest Snapshot** reads the current tokenURI from chain, asks the owner wallet to sign the decrypt challenge, and restores local files from the published state. The current tokenURI is the source of truth.
 
-Publishing replaces the current onchain pointer. Registration metadata contains the current CIDs only.
-
-## Public Discovery
-
-The public registration metadata is intentionally compact. It describes the current state of the agent, not its history.
-
-It can include:
-
-* Agent name, description, and image.
-* Current encrypted continuity CID.
-* Current public `skills.json` CID.
-* Current Agent Card CID.
-* Service entries with canonical `endpoint` values.
-* Registry linkage through `registrations[]`.
-
-This is enough for baseline agent-to-agent discovery and delegation without exposing private memory or installing executable code.
+Agents can also be looked up by token ID on [8004scan](https://8004scan.io/).
 
 ## Models
 
 ethagent works with OpenAI, Anthropic, Gemini, and local GGUF models served through a llama.cpp-compatible endpoint.
 
-The model picker can discover provider models, manage cloud API keys, recommend GGUF files for the machine, and start or reconnect to a local runner when supported.
-
-The featured local model is [Qwen3.5-9B-Uncensored](https://huggingface.co/HauhauCS/Qwen3.5-9B-Uncensored-HauhauCS-Aggressive). You can also add other Hugging Face GGUF models by repo ID or URL.
+The model picker discovers provider models, manages API keys, recommends GGUF files for your machine, and starts or attaches to a local runner. The featured local model is [Qwen3.5-9B-Uncensored](https://huggingface.co/HauhauCS/Qwen3.5-9B-Uncensored-HauhauCS-Aggressive); other Hugging Face GGUF models work by repo ID or URL.
 
-Cloud API keys are stored in the OS keyring when available. If a keyring is unavailable, ethagent uses an encrypted local file under `~/.ethagent`.
+Cloud API keys live in the OS keyring when available, with an encrypted local file under `~/.ethagent` as fallback.
 
-## Tools And Workspace
+## Tools & Sessions
 
-ethagent is built for real project work. It can read files, edit files, write new files, delete files, inspect directories, run shell commands, copy text to the clipboard, and connect MCP tools.
+File ops, shell, clipboard, and MCP tools, all permissioned. Managed edits support `/rewind`. Sessions support `/resume`, `/compact`, and `/export`.
 
-Tool use is permissioned. Managed edits are tracked so recent workspace changes can be rewound from inside the agent.
-
-Sessions are local. You can resume prior sessions, export a transcript, compact older context, and review saved project permissions.
+`Shift+Tab` cycles Plan, Accept-Edits, and Chat modes. `Alt+T` toggles reasoning display.
 
 ## Privacy
 
 Public information includes token ownership, tokenURI metadata, public discovery files, and IPFS CIDs.
 
-Private information includes plaintext `SOUL.md`, plaintext `MEMORY.md`, sessions, prompt history, API keys, local permissions, and wallet signatures used for decrypting continuity.
+Private information includes plaintext `SOUL.md`, plaintext `MEMORY.md`, sessions, prompt history, API keys, local permissions, and wallet signatures used for decryption.
 
 Continuity snapshots use an EIP-191 wallet signature as unlock material and encrypt with ML-KEM-1024, HKDF-SHA256, and AES-256-GCM. The unlock signature does not submit a transaction, spend funds, or grant token approval.
 
-If an ERC-8004 token is transferred, the new holder can see public metadata and encrypted backup CIDs. They cannot decrypt private continuity that was encrypted for the previous owner wallet.
-
-## Local Reset
-
-`ethagent reset` deletes local ethagent data from this machine while preserving installed local model assets. It does not burn or transfer ERC-8004 tokens, remove public IPFS content, or mutate onchain metadata.
+If an ERC-8004 token is transferred, the new holder can see public metadata and encrypted backup CIDs. They cannot decrypt private continuity that was sealed for the previous owner wallet.
 
-Before resetting, use **Publish Snapshot Now** if local continuity changes should become the current recoverable state.
+`ethagent reset` deletes local ethagent data from this machine while preserving installed local model assets. It does not burn or transfer ERC-8004 tokens, remove public IPFS content, or mutate onchain metadata. Run **Save Snapshot Now** before resetting if local changes should become the recoverable state.
 
 ## Architecture
 
@@ -129,10 +72,6 @@ Before resetting, use **Publish Snapshot Now** if local continuity changes shoul
 
 The ERC-8004 token is the durable handle. The machine, model, and local session can change around it.
 
-## Links
-
 [npm](https://www.npmjs.com/package/ethagent) · [GitHub](https://github.com/baairon/ethagent) · [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) · [soul.md](https://soul.md/)
 
-## License
-
-MIT
+MIT License.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ethagent",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "A privacy-first AI agent with a portable Ethereum identity",
   "type": "module",
   "main": "bin/ethagent.js",
@@ -23,14 +23,16 @@
   },
   "keywords": [
     "ethereum",
-    "agent",
-    "ai",
-    "privacy-first",
+    "erc-8004",
+    "ai-agent",
+    "cli",
+    "privacy",
     "ipfs",
-    "ERC-8004",
-    "onchain",
-    "offline",
-    "ens"
+    "wallet",
+    "llm",
+    "gguf",
+    "mcp",
+    "identity"
   ],
   "repository": {
     "type": "git",

package/src/app/FirstRun.tsx

@@ -289,6 +289,7 @@ export const FirstRun: React.FC<FirstRunProps> = ({ onComplete, onCancel }) => {
           <TextInput
             isSecret
             placeholder={provider === 'openai' ? 'sk-...' : 'paste key and press enter'}
+            chromeWidth={4}
             validate={v => v.trim().length >= 8 ? null : 'key looks too short'}
             onSubmit={async value => {
               const trimmed = value.trim()
@@ -326,6 +327,7 @@ export const FirstRun: React.FC<FirstRunProps> = ({ onComplete, onCancel }) => {
           <TextInput
             initialValue={defaultModel}
             placeholder={defaultModel}
+            chromeWidth={4}
             onSubmit={model => goTo({
               kind: 'saving',
               config: withFirstRunIdentity({

package/src/chat/ChatScreen.tsx

@@ -143,6 +143,7 @@ export const ChatScreen: React.FC<ChatScreenProps> = ({ config: initialConfig, o
   const [mode, setMode] = useState<SessionMode>('chat')
   const [pendingPlan, setPendingPlan] = useState<PendingPlan | null>(null)
   const [compactionUi, setCompactionUi] = useState<CompactionUiState | null>(null)
+  const [canScrollTranscript, setCanScrollTranscript] = useState(false)
   const [sessionId, setSessionId] = useState<string>(() => newSessionId())
   const [sessionKey, setSessionKey] = useState<number>(0)
   const [cwd, setCwd] = useState<string>(() => syncCwdFromProcess())
@@ -1094,6 +1095,7 @@ export const ChatScreen: React.FC<ChatScreenProps> = ({ config: initialConfig, o
             : `open failed: ${result.error}`,
           result.ok ? 'dim' : 'error',
         )
+        if (result.ok) setContinuityEditReview(prev => prev ? { ...prev, editorOpened: true } : null)
         return
       }
       setContinuityEditReview(null)
@@ -1398,9 +1400,7 @@ export const ChatScreen: React.FC<ChatScreenProps> = ({ config: initialConfig, o
           <Text color={theme.dim}> · </Text>
         </>
       )}
-      <Text color={theme.dim}>
-        {'pgup/pgdn scroll · alt+p model · alt+i identity'}
-      </Text>
+      <Text color={theme.dim}>{chatFooterShortcutText(canScrollTranscript)}</Text>
     </Box>
   )
   const header = <BrandSplash contextLine={contextLine} tipLine={tipLine} updateNotice={updateNotice ?? null} />
@@ -1466,10 +1466,15 @@ export const ChatScreen: React.FC<ChatScreenProps> = ({ config: initialConfig, o
       )}
       sessionKey={sessionKey}
       onVisibleReasoningIdsChange={updateVisibleReasoningIds}
+      onTranscriptScrollabilityChange={setCanScrollTranscript}
     />
   )
 }
 
+export function chatFooterShortcutText(canScrollTranscript: boolean): string {
+  return `${canScrollTranscript ? 'pgup/pgdn scroll · ' : ''}alt+p model · alt+i identity`
+}
+
 function formatContextLabel(usage: ContextUsage): string {
   if (!Number.isFinite(usage.usedTokens) || usage.usedTokens <= 0) return 'Estimated context: empty'
   return `Estimated context: ${usage.percent}% used`

package/src/chat/ContinuityEditReviewView.tsx

@@ -8,6 +8,7 @@ export type ContinuityEditReviewState = {
   file: 'SOUL.md' | 'MEMORY.md'
   filePath: string
   summary: string
+  editorOpened?: boolean
 }
 
 export type ContinuityEditReviewAction = 'open' | 'save-publish' | 'later'
@@ -28,6 +29,11 @@ export const ContinuityEditReviewView: React.FC<{
         <Text color={theme.textSubtle}>review file</Text>
         <Text color={theme.text}>{review.filePath}</Text>
       </Box>
+      {review.editorOpened && (
+        <Box marginTop={1}>
+          <Text color={theme.accentPeach}>Save with ctrl+s in your editor</Text>
+        </Box>
+      )}
       <Box marginTop={1} flexDirection="column">
         <Text color={theme.textSubtle}>saved locally</Text>
         <Text color={theme.dim}>Previous version saved in identity history. /rewind does not restore identity continuity.</Text>

package/src/chat/ConversationStack.tsx

@@ -12,6 +12,7 @@ type ConversationStackProps = {
   status?: React.ReactNode
   sessionKey: number
   onVisibleReasoningIdsChange?: (ids: string[]) => void
+  onTranscriptScrollabilityChange?: (canScroll: boolean) => void
 }
 
 export const ConversationStack: React.FC<ConversationStackProps> = ({
@@ -23,6 +24,7 @@ export const ConversationStack: React.FC<ConversationStackProps> = ({
   status,
   sessionKey,
   onVisibleReasoningIdsChange,
+  onTranscriptScrollabilityChange,
 }) => {
   return (
     <Box flexDirection="column" padding={1}>
@@ -33,6 +35,7 @@ export const ConversationStack: React.FC<ConversationStackProps> = ({
         active={transcriptActive}
         bottomVariant={bottomVariant}
         onVisibleReasoningIdsChange={onVisibleReasoningIdsChange}
+        onScrollabilityChange={onTranscriptScrollabilityChange}
       />
       <Box marginTop={1} width="100%">
         {bottom}

package/src/chat/TranscriptView.tsx

@@ -21,6 +21,7 @@ type TranscriptViewProps = {
   active?: boolean
   bottomVariant?: 'prompt' | 'overlay'
   onVisibleReasoningIdsChange?: (ids: string[]) => void
+  onScrollabilityChange?: (canScroll: boolean) => void
 }
 
 const PROMPT_RESERVED_LINES = 11
@@ -33,6 +34,7 @@ export const TranscriptView: React.FC<TranscriptViewProps> = ({
   active = true,
   bottomVariant = 'prompt',
   onVisibleReasoningIdsChange,
+  onScrollabilityChange,
 }) => {
   const { stdout } = useStdout()
   const columns = stdout.columns ?? process.stdout.columns ?? 80
@@ -89,6 +91,10 @@ export const TranscriptView: React.FC<TranscriptViewProps> = ({
     onVisibleReasoningIdsChange?.(visibleReasoningIds)
   }, [onVisibleReasoningIdsChange, visibleReasoningIds])
 
+  useEffect(() => {
+    onScrollabilityChange?.(metrics.maxScrollTop > 0)
+  }, [metrics.maxScrollTop, onScrollabilityChange])
+
   useAppInput((_input, key) => {
     if (key.pageUp) {
       const target = promptScrollTopForPageUp(

package/src/chat/chatTurnOrchestrator.ts

@@ -665,7 +665,7 @@ export async function buildIdentityContinuityContextMessages(
       content: [
         '<identity_continuity_files>',
         `Automatic identity continuity load failed: ${(err as Error).message}`,
-        'If the user asks about continuity, surface this failure and route them to the identity hub.',
+        'If the user asks about continuity, surface this failure and route them to the Identity Hub.',
         '</identity_continuity_files>',
       ].join('\n'),
     }]

package/src/cli/updateNotice.ts

@@ -24,7 +24,7 @@ export function isNewerVersion(candidate: string, current: string): boolean {
 
 export function formatUpdateNotice(currentVersion: string, latestVersion: string): string | null {
   if (!isNewerVersion(latestVersion, currentVersion)) return null
-  return `update available: ethagent ${currentVersion} -> ${latestVersion}; run npm i -g ethagent`
+  return `✨ update available: ethagent ${currentVersion} -> ${latestVersion} · run npm i -g ethagent@latest`
 }
 
 export async function checkForUpdates(

package/src/identity/hub/IdentityHub.tsx

@@ -381,8 +381,8 @@ export const IdentityHub: React.FC<IdentityHubProps> = ({ mode, config, initialA
         ? `opened ${kind === 'soul' ? 'SOUL.md' : kind === 'memory' ? 'MEMORY.md' : 'skills.json'} with ${result.method}.`
         : `open failed: ${result.error}`
       setStep(kind === 'skills'
-        ? { kind: 'continuity-public', notice: message }
-        : { kind: 'continuity-private', notice: message })
+        ? { kind: 'continuity-public', notice: message, editorOpened: result.ok }
+        : { kind: 'continuity-private', notice: message, editorOpened: result.ok })
     } catch (err: unknown) {
       errorStep(err, kind === 'skills' ? { kind: 'continuity-public' } : { kind: 'continuity-private' })
     }
@@ -609,6 +609,7 @@ export const IdentityHub: React.FC<IdentityHubProps> = ({ mode, config, initialA
         ready={continuityReady}
         notice={step.notice}
         footer={footer}
+        editorOpened={step.editorOpened}
         onOpenSoul={() => { void openContinuityFile('soul') }}
         onOpenMemory={() => { void openContinuityFile('memory') }}
         onBack={back}
@@ -625,6 +626,7 @@ export const IdentityHub: React.FC<IdentityHubProps> = ({ mode, config, initialA
         ready={continuityReady}
         notice={step.notice}
         footer={footer}
+        editorOpened={step.editorOpened}
         onEditProfile={() => openPublicProfileEdit({ kind: 'continuity-public' })}
         onOpenSkills={() => { void openContinuityFile('skills') }}
         onBack={back}

package/src/identity/hub/identityHubModel.ts

@@ -6,6 +6,7 @@ import {
 } from '../registry/erc8004.js'
 import { AgentStateOwnerMismatchError } from '../crypto/backupEnvelope.js'
 import { ContinuitySnapshotOwnerMismatchError } from '../continuity/envelope.js'
+import type { ContinuityWorkingTreeStatus } from '../continuity/storage.js'
 import { resolveSelectedNetwork } from '../registry/registryConfig.js'
 
 export const PREFLIGHT_AGENT_URI = 'ipfs://bafybeigdyrztma2dbfczw7q6ooozbxlqzyw5r7w4f3qw2axvvxqg3w6y7q'
@@ -214,6 +215,85 @@ export function identitySummaryRows(
   ]
 }
 
+export type LocalChangeStatusView = {
+  label: string
+  detail: string
+  tone: 'ok' | 'warn' | 'dim'
+  files: string[]
+  hasLocalChanges: boolean
+}
+
+export function changedContinuitySnapshotFiles(
+  workingStatus?: ContinuityWorkingTreeStatus | null,
+): string[] {
+  if (!workingStatus?.localContentHashes || !workingStatus.publishedContentHashes) return []
+  const files: Array<keyof typeof workingStatus.localContentHashes> = ['SOUL.md', 'MEMORY.md', 'skills.json']
+  return files.filter(file => workingStatus.localContentHashes?.[file] !== workingStatus.publishedContentHashes?.[file])
+}
+
+export function localChangeStatusView(
+  workingStatus?: ContinuityWorkingTreeStatus | null,
+): LocalChangeStatusView {
+  if (!workingStatus) {
+    return {
+      label: 'Local Changes',
+      detail: 'Checking status...',
+      tone: 'dim',
+      files: [],
+      hasLocalChanges: false,
+    }
+  }
+
+  if (workingStatus.publishState === 'published') {
+    return {
+      label: 'Local Changes',
+      detail: 'None detected',
+      tone: 'ok',
+      files: [],
+      hasLocalChanges: false,
+    }
+  }
+
+  if (workingStatus.publishState === 'local-changes') {
+    const files = changedContinuitySnapshotFiles(workingStatus)
+    return {
+      label: 'Local Changes',
+      detail: files.length > 0 ? `Detected: ${files.join(', ')}` : 'Detected: local files differ from saved snapshot',
+      tone: 'warn',
+      files,
+      hasLocalChanges: true,
+    }
+  }
+
+  if (workingStatus.publishState === 'not-published') {
+    return {
+      label: 'Local Changes',
+      detail: 'Snapshot not saved yet',
+      tone: 'warn',
+      files: [],
+      hasLocalChanges: false,
+    }
+  }
+
+  if (workingStatus.publishState === 'verify-needed') {
+    return {
+      label: 'Local Changes',
+      detail: 'Unable to verify saved snapshot',
+      tone: 'warn',
+      files: [],
+      hasLocalChanges: false,
+    }
+  }
+
+  return {
+    label: 'Local Changes',
+    detail: 'Local files not restored',
+    tone: 'warn',
+    files: [],
+    hasLocalChanges: false,
+  }
+}
+
 export type IdentityDetailSection = {
   title: string
   rows: Array<{

package/src/identity/hub/identityHubReducer.ts

@@ -31,8 +31,8 @@ export type Step =
   | { kind: 'restore-authorizing'; cid: string; apiUrl: string; envelope: RestorableBackupEnvelope; candidate: Erc8004AgentCandidate; purpose?: RestorePurpose }
   | { kind: 'rebackup-signing'; identity: EthagentIdentity; registry: Erc8004RegistryConfig; pinataJwt?: string; profileUpdates?: ProfileUpdates; returnTo?: Step }
   | { kind: 'rebackup-storage'; identity: EthagentIdentity; registry: Erc8004RegistryConfig; error?: string; pinataJwt?: string; profileUpdates?: ProfileUpdates; returnTo?: Step }
-  | { kind: 'continuity-private'; notice?: string }
-  | { kind: 'continuity-public'; notice?: string }
+  | { kind: 'continuity-private'; notice?: string; editorOpened?: boolean }
+  | { kind: 'continuity-public'; notice?: string; editorOpened?: boolean }
   | { kind: 'rebackup-confirm'; back: Step }
   | { kind: 'recovery-refetch-confirm'; back: Step }
   | { kind: 'recovery-refetching'; identity: EthagentIdentity; registry: Erc8004RegistryConfig; back: Step }

package/src/identity/hub/screens/ContinuityDashboardScreen.tsx

@@ -17,6 +17,7 @@ type CommonProps = {
   workingStatus?: ContinuityWorkingTreeStatus | null
   ready: boolean
   notice?: string
+  editorOpened?: boolean
   footer: React.ReactNode
   onBack: () => void
 }
@@ -42,6 +43,7 @@ export const PrivateContinuityScreen: React.FC<CommonProps & {
   workingStatus,
   ready,
   notice,
+  editorOpened,
   footer,
   onOpenSoul,
   onOpenMemory,
@@ -51,6 +53,11 @@ export const PrivateContinuityScreen: React.FC<CommonProps & {
     <IdentitySummary identity={identity} config={config} workingStatus={workingStatus} compact />
     <PrivateRows identity={identity} ready={ready} />
     <SaveFromHubHint workingStatus={workingStatus} />
+    {editorOpened && (
+      <Box marginTop={1}>
+        <Text color={theme.accentPeach}>Save with ctrl+s in your editor</Text>
+      </Box>
+    )}
     <Box marginTop={1}>
       <Select<PrivateAction>
         options={[
@@ -75,11 +82,16 @@ export const PrivateContinuityScreen: React.FC<CommonProps & {
 export const PublicSkillsScreen: React.FC<CommonProps & {
   onEditProfile: () => void
   onOpenSkills: () => void
-}> = ({ identity, config, workingStatus, notice, footer, onEditProfile, onOpenSkills, onBack }) => (
+}> = ({ identity, config, workingStatus, notice, editorOpened, footer, onEditProfile, onOpenSkills, onBack }) => (
   <Surface title="Public Profile" subtitle={notice ?? 'Manage public metadata, skills.json, and the agent card.'} footer={footer}>
     <IdentitySummary identity={identity} config={config} workingStatus={workingStatus} compact />
     <PublicProfileRows identity={identity} />
     <SaveFromHubHint workingStatus={workingStatus} />
+    {editorOpened && (
+      <Box marginTop={1}>
+        <Text color={theme.accentPeach}>Save with ctrl+s in your editor</Text>
+      </Box>
+    )}
     <Box marginTop={1}>
       <Select<PublicAction>
         options={[
@@ -135,7 +147,7 @@ const PublicProfileRows: React.FC<{ identity?: EthagentIdentity }> = ({ identity
 function privateSubtitle(ready: boolean): string {
   return ready
     ? 'SOUL.md and MEMORY.md are private local files on this machine.'
-    : 'Use "Refetch Latest Snapshot" from the hub menu to recover files.'
+    : 'Use "Refetch Latest Snapshot" from the Identity Hub menu to recover files.'
 }
 
 function readStateString(state: Record<string, unknown> | undefined, key: string): string {

package/src/identity/hub/screens/EditProfileFlow.tsx

@@ -120,6 +120,7 @@ export const EditProfileFlow: React.FC<EditProfileFlowProps> = ({
         initialValue={currentDescription}
         placeholder="description"
         allowEmpty
+        multiline
         onSubmit={value => onDescriptionSubmit(value.trim())}
         onCancel={onBack}
       />

package/src/identity/hub/screens/ErrorScreen.tsx

@@ -22,7 +22,7 @@ export const ErrorScreen: React.FC<ErrorScreenProps> = ({ error, back, footer, o
         { value: 'back', role: 'section', prefix: '--', label: 'Recovery' },
         { value: 'back', label: 'Go Back', hint: 'Return to the previous identity step' },
         { value: 'close', role: 'section', prefix: '--', label: 'Exit' },
-        { value: 'close', label: 'Close Hub', hint: 'Return to chat without retrying', role: 'utility' },
+        { value: 'close', label: 'Close Identity Hub', hint: 'Return to chat without retrying', role: 'utility' },
       ]}
       hintLayout="inline"
       onSubmit={choice => {

package/src/identity/hub/screens/IdentitySummary.tsx

@@ -2,10 +2,22 @@ import React from 'react'
 import { Box, Text } from 'ink'
 import { theme } from '../../../ui/theme.js'
 import type { EthagentConfig, EthagentIdentity } from '../../../storage/config.js'
-import { identitySummaryRows, lastBackupLabel } from '../identityHubModel.js'
+import {
+  identitySummaryRows,
+  lastBackupLabel,
+  localChangeStatusView,
+  type LocalChangeStatusView,
+} from '../identityHubModel.js'
 
 import type { ContinuityWorkingTreeStatus } from '../../continuity/storage.js'
 
+type SummaryRow = {
+  label: string
+  value: string
+  tone: 'ok' | 'dim' | 'warn'
+  highlight?: boolean
+}
+
 export const IdentitySummary: React.FC<{
   identity?: EthagentIdentity
   config?: EthagentConfig
@@ -25,24 +37,10 @@ export const IdentitySummary: React.FC<{
     : ''
 
   const row = (label: string) => rows.find(item => item.label === label)
-  
-  const needsBackup = workingStatus?.publishState === 'local-changes' || workingStatus?.publishState === 'not-published' || workingStatus?.publishState === 'verify-needed'
-  let changedFiles: string[] = []
-  if (needsBackup) {
-    if (workingStatus?.localContentHashes && workingStatus?.publishedContentHashes) {
-      if (workingStatus.localContentHashes['SOUL.md'] !== workingStatus.publishedContentHashes['SOUL.md']) changedFiles.push('SOUL.md')
-      if (workingStatus.localContentHashes['MEMORY.md'] !== workingStatus.publishedContentHashes['MEMORY.md']) changedFiles.push('MEMORY.md')
-      if (workingStatus.localContentHashes['skills.json'] !== workingStatus.publishedContentHashes['skills.json']) changedFiles.push('skills.json')
-    } else {
-      changedFiles = ['SOUL.md', 'MEMORY.md', 'skills.json']
-    }
-  }
+  const localChangeStatus = localChangeStatusView(workingStatus)
+  const lastSavedRow: SummaryRow = { label: 'Last Saved', value: lastBackup, tone: lastBackup === 'never' ? 'dim' : 'ok' }
 
-  const lastSavedRow = needsBackup
-    ? { label: 'Unsaved', value: changedFiles.length > 0 ? changedFiles.join(', ') : 'Markdown files', tone: 'warn' as const, highlight: true }
-    : { label: 'Last Saved', value: lastBackup, tone: lastBackup === 'never' ? 'dim' as const : 'ok' as const }
-
-  const summaryRows = [
+  const summaryRows: SummaryRow[] = [
     { label: 'Token', value: row('token')?.value ?? 'Not Created', tone: row('token')?.tone ?? 'dim', highlight: true },
     { label: 'Network', value: row('network')?.value ?? 'Unknown', tone: row('network')?.tone ?? 'dim' },
     { label: 'Owner', value: row('owner')?.value ?? 'Not Connected', tone: row('owner')?.tone ?? 'dim' },
@@ -57,18 +55,36 @@ export const IdentitySummary: React.FC<{
     <Box flexDirection="column">
       <Text color={theme.accentPrimary} bold>{stateName || 'Active Agent'}</Text>
       {summaryRows.map(row => {
-        const valueColor = row.tone === 'warn' ? 'red' : (row.tone === 'ok' ? theme.text : theme.dim)
+        const valueColor = row.tone === 'warn' ? '#e87070' : (row.tone === 'ok' ? theme.text : theme.dim)
         return (
           <Text key={row.label}>
             <Text color={theme.dim}>{row.label.padEnd(12)}</Text>
-            <Text color={valueColor} bold={row.highlight}>{displayValue(row.value)}</Text>
+            <Text color={valueColor} bold={row.highlight ?? false}>{displayValue(row.value)}</Text>
           </Text>
         )
       })}
+      <Box marginTop={1}>
+        <LocalChangeStatusLine status={localChangeStatus} />
+      </Box>
     </Box>
   )
 }
 
+const LocalChangeStatusLine: React.FC<{ status: LocalChangeStatusView }> = ({ status }) => {
+  if (status.hasLocalChanges) {
+    return (
+      <Text color="#e87070" bold>
+        Local changes detected
+        {status.files.length > 0 ? `: ${status.files.join(', ')}` : ''}
+      </Text>
+    )
+  }
+
+  const color = status.tone === 'ok' ? theme.accentMint : status.tone === 'warn' ? theme.accentPeach : theme.dim
+  const label = status.detail === 'None detected' ? 'No local changes detected' : status.detail
+  return <Text color={color}>{label}</Text>
+}
+
 function displayValue(value: string): string {
   const mapped = DISPLAY_VALUES[value]
   return mapped ?? value