@c4t4/heyamigo 0.1.4 → 0.1.8

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
@@ -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

@@ -25,7 +25,6 @@
 
   "claude": {
     "model": "claude-opus-4-6",
-    "timeoutMs": 60000,
     "personalityFile": "./config/personalities/sharp.md",
     "addDirs": ["./config/knowledge"],
     "outputFormat": "json",
@@ -60,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/ai/claude.js

@@ -65,11 +65,6 @@ export async function askClaude(params) {
         });
         let stdout = '';
         let stderr = '';
-        let timedOut = false;
-        const timer = setTimeout(() => {
-            timedOut = true;
-            child.kill('SIGTERM');
-        }, config.claude.timeoutMs);
         child.stdout.on('data', (chunk) => {
             stdout += chunk.toString('utf-8');
         });
@@ -77,7 +72,6 @@ export async function askClaude(params) {
             stderr += chunk.toString('utf-8');
         });
         child.on('error', (err) => {
-            clearTimeout(timer);
             void logPrompt({
                 ts: Math.floor(startedAt / 1000),
                 caller: 'worker',
@@ -89,18 +83,6 @@ export async function askClaude(params) {
             rejectPromise(new Error(`claude spawn failed: ${err.message}`));
         });
         child.on('close', (code) => {
-            clearTimeout(timer);
-            if (timedOut) {
-                void logPrompt({
-                    ts: Math.floor(startedAt / 1000),
-                    caller: 'worker',
-                    args,
-                    input: params.input,
-                    error: 'timed out',
-                    durationMs: Date.now() - startedAt,
-                });
-                return rejectPromise(new Error(`claude timed out after ${config.claude.timeoutMs}ms`));
-            }
             if (code !== 0) {
                 void logPrompt({
                     ts: Math.floor(startedAt / 1000),

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',
         '',
@@ -679,12 +682,25 @@ export async function runSetup() {
         '  config/access.json   — groups, DMs, roles',
     ].join('\n'), 'Setup complete!');
     p.log.warning('IMPORTANT: The bot won\'t respond until you activate a group!\n\n' +
-        '  1. Start the bot and send a message in any WhatsApp group.\n' +
-        '     The bot discovers the group and adds it to config/access.json.\n\n' +
-        '  2. Edit config/access.json:\n' +
-        '     - Change the group\'s mode from "off" to "active"\n' +
-        '     - Set allowedSenders to "*" (everyone) or specific numbers\n\n' +
-        '  3. Mention the bot\'s name in a message to get a reply.\n\n' +
-        '  For DMs: add numbers to dms.allowed in config/access.json.');
+        '  Step 1 — Start the bot:\n' +
+        '    npx @c4t4/heyamigo start\n\n' +
+        '  Step 2 — Send a message in any WhatsApp group.\n' +
+        '    The bot discovers the group and adds it to config/access.json.\n\n' +
+        '  Step 3 — Open config/access.json and edit:\n' +
+        '    nano config/access.json\n' +
+        '    - Find the group, change mode from "off" to "active"\n' +
+        '    - Set allowedSenders to "*" for everyone\n\n' +
+        '  Step 4 — Restart the bot:\n' +
+        '    npx @c4t4/heyamigo restart\n\n' +
+        '  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/config.js

@@ -25,7 +25,6 @@ const ConfigSchema = z.object({
     }),
     claude: z.object({
         model: z.string(),
-        timeoutMs: z.number(),
         personalityFile: z.string(),
         addDirs: z.array(z.string()),
         outputFormat: z.enum(['json', 'text', 'stream-json']),

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) => {
@@ -24,11 +26,6 @@ async function spawnDigester(prompt) {
         });
         let stdout = '';
         let stderr = '';
-        let timedOut = false;
-        const timer = setTimeout(() => {
-            timedOut = true;
-            child.kill('SIGTERM');
-        }, config.claude.timeoutMs);
         child.stdout.on('data', (chunk) => {
             stdout += chunk.toString('utf-8');
         });
@@ -44,16 +41,10 @@ async function spawnDigester(prompt) {
             durationMs: Date.now() - startedAt,
         });
         child.on('error', (err) => {
-            clearTimeout(timer);
             logFail(`spawn failed: ${err.message}`);
             rejectPromise(new Error(`digester spawn failed: ${err.message}`));
         });
         child.on('close', (code) => {
-            clearTimeout(timer);
-            if (timedOut) {
-                logFail('timed out');
-                return rejectPromise(new Error('digester timed out'));
-            }
             if (code !== 0) {
                 logFail(`exit ${code}: ${stderr.slice(0, 300)}`);
                 return rejectPromise(new Error(`digester exit ${code}: ${stderr.slice(0, 300)}`));

package/dist/memory/preamble.js

@@ -38,6 +38,18 @@ export function buildMemoryPreamble(params) {
     // Identity — tell Claude its name
     const botName = config.triggers.aliases[0] ?? 'amigo';
     sections.push(`[Identity]\nYour name is ${botName}. People call you ${botName} to get your attention.`);
+    // Capabilities
+    sections.push('[Capabilities]\n' +
+        'Sending files: include a tag in your reply to send files through WhatsApp:\n' +
+        '  [IMAGE: /absolute/path/to/file.png]\n' +
+        '  [VIDEO: /absolute/path/to/file.mp4]\n' +
+        '  [AUDIO: /absolute/path/to/file.mp3]\n' +
+        '  [DOCUMENT: /absolute/path/to/file.pdf]\n' +
+        'The tag will be stripped from the message. Use absolute paths only.\n\n' +
+        'Browser: you have a real Chrome browser available via Playwright.\n' +
+        'You can navigate to URLs, click, fill forms, take screenshots, and read page content.\n' +
+        'Use the browser tools (mcp__playwright__*) when asked to visit websites, look something up, or take a screenshot.\n' +
+        'To send a screenshot back, take one with the browser tool, then include [IMAGE: /path/to/screenshot.png] in your reply.');
     // Critical section
     sections.push(buildCriticalSection({
         senderNumber: params.senderNumber,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4t4/heyamigo",
-  "version": "0.1.4",
+  "version": "0.1.8",
   "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": {