@c4t4/heyamigo 0.1.5 → 0.1.9

package/README.md

@@ -92,14 +92,15 @@ That's it. Runs in the background, auto-restarts on crash, survives SSH disconne
 ## Commands
 
 ```
-heyamigo setup           # setup wizard (includes WhatsApp pairing)
-heyamigo start           # start (background, auto-restart)
-heyamigo stop            # stop
-heyamigo restart         # restart
-heyamigo logs            # tail live logs
-heyamigo status          # check if running
-heyamigo import <path>   # import knowledge folder
-heyamigo dev             # foreground (development)
+npx @c4t4/heyamigo setup           # setup wizard
+npx @c4t4/heyamigo start           # start (background, auto-restart)
+npx @c4t4/heyamigo stop            # stop
+npx @c4t4/heyamigo restart         # restart
+npx @c4t4/heyamigo logs            # tail live logs
+npx @c4t4/heyamigo status          # check if running
+npx @c4t4/heyamigo update          # update to latest version
+npx @c4t4/heyamigo import <path>   # import knowledge folder
+npx @c4t4/heyamigo dev             # foreground (development)
 ```
 
 ### In-chat commands
@@ -130,6 +131,16 @@ storage/memory/
   chats/         per-chat briefs
 ```
 
+### How memory updates
+
+The bot updates memory in two ways:
+
+**Real-time (DIGEST flag):** During a conversation, Claude decides if something is worth remembering (a preference, fact, life event). It appends a hidden `[DIGEST: reason]` tag to its reply, which gets stripped before sending. This triggers a background digest within 2 minutes that updates the person's profile and the chat brief.
+
+**Background sweep:** Every 3 hours, the bot checks all active chats for new messages that weren't flagged. This catches anything Claude missed. You can also force an immediate update with the `/digest` command in chat.
+
+Memory is stored as plain markdown files. You can read, edit, or delete them directly.
+
 ---
 
 ## Roles
@@ -160,13 +171,13 @@ All localhost. Nothing public.
 
 Three built-in:
 
-**Sharp** (default)
+[**Sharp**](config/personalities/sharp.md) (default)
 Talks like a smart friend at dinner. Specific, confident, never vague. Won't hedge, won't lecture, won't sound like a brochure. Calls things out when they're obvious, meets people where they actually are. Checks every reply against: would I be embarrassed saying this out loud?
 
-**Casual**
+[**Casual**](config/personalities/casual.md)
 Warm, relaxed, friend-over-coffee energy. Short messages, matches your vibe.
 
-**Professional**
+[**Professional**](config/personalities/professional.md)
 Clear, efficient, business-appropriate. Gets to the answer fast.
 
 Create your own: add a `.md` file to `config/personalities/`, point `config.json` at it.
@@ -244,6 +255,22 @@ Not compatible with serverless (Lambda, Vercel). Needs a persistent WebSocket co
 
 ---
 
+## Tracking memory with git
+
+The bot updates files in `storage/memory/` over time as it learns. We recommend tracking your project with git so you can see what changed and roll back if needed.
+
+```bash
+cd ~/heyamigo
+git init
+echo "storage/auth/" >> .gitignore
+echo "storage/logs/" >> .gitignore
+git add -A && git commit -m "initial setup"
+```
+
+Never commit `storage/auth/` — it contains your WhatsApp session keys.
+
+---
+
 ## Security
 
 - `storage/auth/` contains your WhatsApp session keys. Guard them.

package/config/config.example.json

@@ -59,7 +59,7 @@
     "importInstructionsFile": "./config/import-instructions.md",
     "importPermissionMode": "acceptEdits",
     "digestDebounceMs": 120000,
-    "sweepIntervalMs": 21600000,
+    "sweepIntervalMs": 10800000,
     "sweepMinNewMessages": 5,
     "maxHistoryForDigest": 100
   },

package/config/personalities/sharp.md

@@ -14,12 +14,16 @@ Talk like a friend at dinner, not a brochure. If you wouldn't say it out loud to
 
 Confident, charming, magnetic. Never arrogant, weak, or desperate.
 
-- Confident: state things without hedging. No "maybe", no "possibly", no "könnte eventuell".
+- Confident: state things without hedging. No "maybe", no "possibly".
 - Charming: light enough that people nod or smile, not feel lectured.
 - Magnetic: don't chase, don't beg, don't push.
 
 Avoid: lecturing (arrogant), hedging (weak), over-eager pushing (desperate).
 
+## Nuance
+
+Super nuanced. See the layers in things. Most questions have a surface answer and a real answer. Give the real one. Notice tensions, trade-offs, and contradictions that others gloss over. When something is genuinely complicated, say so, but still take a position. Nuance doesn't mean wishy-washy. It means you see more and still commit.
+
 ## Rules
 
 - Name the elephant. If something obvious is awkward, say it first.

package/dist/cli/index.js

@@ -60,6 +60,23 @@ program
         process.exit(1);
     }
 });
+program
+    .command('update')
+    .alias('upgrade')
+    .description('Update heyamigo to the latest version')
+    .action(async () => {
+    const { execSync } = await import('child_process');
+    console.log('Updating @c4t4/heyamigo...');
+    try {
+        execSync('npm install @c4t4/heyamigo@latest', { stdio: 'inherit' });
+        console.log('\nUpdated. Restart the bot:');
+        console.log('  npx @c4t4/heyamigo restart');
+    }
+    catch {
+        console.error('Update failed. Try manually: npm install @c4t4/heyamigo@latest');
+        process.exit(1);
+    }
+});
 program
     .command('dev')
     .description('Start in foreground with file watching (development)')

package/dist/cli/setup.js

@@ -671,6 +671,9 @@ export async function runSetup() {
         'Import existing knowledge:',
         '  npx @c4t4/heyamigo import /path/to/folder',
         '',
+        'Update to latest version:',
+        '  npx @c4t4/heyamigo update',
+        '',
         'Other commands:',
         '  npx @c4t4/heyamigo stop / restart / status',
         '',
@@ -692,5 +695,12 @@ export async function runSetup() {
         '  Step 5 — Mention the bot\'s name in the group to get a reply.\n\n' +
         '  Debugging:\n' +
         '    npx @c4t4/heyamigo logs');
+    p.log.info('TIP: Track your bot\'s memory with git.\n' +
+        'The bot updates files in storage/memory/ over time. Use git to track changes and roll back if needed.\n\n' +
+        '  cd ' + cwd + '\n' +
+        '  git init\n' +
+        '  echo "storage/auth/" >> .gitignore\n' +
+        '  echo "storage/logs/" >> .gitignore\n' +
+        '  git add -A && git commit -m "initial setup"');
     p.outro('Happy chatting!');
 }

package/dist/memory/digest.js

@@ -15,6 +15,8 @@ async function spawnDigester(prompt) {
         'json',
         '--model',
         config.claude.model,
+        '--permission-mode',
+        'acceptEdits',
     ];
     const startedAt = Date.now();
     return new Promise((resolvePromise, rejectPromise) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4t4/heyamigo",
-  "version": "0.1.5",
+  "version": "0.1.9",
   "description": "WhatsApp AI bot powered by Claude with long-term memory, browser control, and role-based access",
   "type": "module",
   "main": "dist/index.js",
@@ -36,6 +36,10 @@
     "bot",
     "anthropic"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/C4T4/heyamigo.git"
+  },
   "author": "Catalin Waack",
   "license": "MIT",
   "publishConfig": {