coder-agent 2.7.3 → 2.8.1

package/dist/agent.js

@@ -831,9 +831,10 @@ ${JSON.stringify(allMessages.slice(1).map(m => ({ role: m.role, content: m.conte
 
 Instructions:
 1. Review the conversation history and extract any important new project setup details, style preferences, build/test commands, package quirks, or persistent instructions that should be remembered for future sessions.
-2. Integrate these new learnings into the existing memory structure. Keep existing useful learnings/preferences, but clean up duplicates or obsolete info.
-3. Keep the content concise, clean, and formatted in Markdown.
-4. If there are no new learnings, setup details, or instructions in the conversation, output EXACTLY the existing memory content. Do not add conversational text, just output the updated/existing markdown content.`;
+2. Maintain and update the "## File-to-Data Map" section. If any files were read, modified, created, or discussed, verify if they are listed in the map. If not, add them with their relative path and a brief 1-sentence description of the data, logic, or functions they contain. If they are already listed but their content/purpose changed, update their description.
+3. Integrate these new learnings and file catalog updates into the existing memory structure. Keep existing useful learnings/preferences, but clean up duplicates or obsolete info.
+4. Keep the content concise, clean, and formatted in Markdown.
+5. If there are no new learnings, setup details, file updates, or instructions in the conversation, output EXACTLY the existing memory content. Do not add conversational text, just output the updated/existing markdown content.`;
             const responseObj = await callGeminiAPIWithRotation(this.apiKey, {
                 model: this.model,
                 messages: [{ role: "user", content: prompt }],

package/dist/config.js

@@ -80,3 +80,16 @@ export async function saveGeminiApiKey(geminiApiKey) {
     config.geminiApiKey = geminiApiKey;
     await writeConfig(config);
 }
+export async function getLastUsedInfo() {
+    const config = await readConfig();
+    return {
+        lastUsedVersion: config.lastUsedVersion,
+        lastUsedTime: config.lastUsedTime,
+    };
+}
+export async function saveLastUsedInfo(version, time) {
+    const config = await readConfig();
+    config.lastUsedVersion = version;
+    config.lastUsedTime = time;
+    await writeConfig(config);
+}

package/dist/index.js

@@ -3,7 +3,8 @@ import * as readline from "readline";
 import chalk from "chalk";
 import figlet from "figlet";
 import { Agent } from "./agent.js";
-import { getStoredApiKey, saveApiKey, getStoredModel, saveModel } from "./config.js";
+import { getStoredApiKey, saveApiKey, getStoredModel, saveModel, getLastUsedInfo, saveLastUsedInfo } from "./config.js";
+const CURRENT_VERSION = "2.7.3";
 const VALID_MODELS = [
     "gemini-2.5-flash",
     "gemini-2.5-pro",
@@ -37,7 +38,7 @@ function printBanner(modelName) {
     });
     console.log('');
     console.log('  ' + chalk.white.bold('coder-agent') +
-        chalk.dim('  v1.1.0'));
+        chalk.dim('  v' + CURRENT_VERSION));
     console.log('');
     console.log(chalk.dim('  ─────────────────────────────────────'));
     console.log('');
@@ -55,7 +56,7 @@ function printBanner(modelName) {
     console.log('');
 }
 function printHelp() {
-    console.log(chalk.white.bold("\n  Coder CLI v1.1\n"));
+    console.log(chalk.white.bold(`\n  Coder CLI v${CURRENT_VERSION}\n`));
     console.log(chalk.gray("  Usage:"));
     console.log(chalk.white("    coder-agent                     — Start the interactive REPL"));
     console.log(chalk.white("    coder-agent [options]           — Run with config options"));
@@ -151,7 +152,7 @@ async function main() {
             process.exit(0);
         }
         else if (args[i] === "-v" || args[i] === "--version") {
-            console.log("coder-agent v1.1.0");
+            console.log(`coder-agent v${CURRENT_VERSION}`);
             process.exit(0);
         }
         else {
@@ -269,12 +270,46 @@ async function main() {
         process.exit(0);
     }
     // Interactive REPL Mode
+    const lastUsedInfo = await getLastUsedInfo();
+    const INACTIVE_THRESHOLD_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+    const isNewUser = !lastUsedInfo.lastUsedTime;
+    const isInactive = lastUsedInfo.lastUsedTime ? (Date.now() - lastUsedInfo.lastUsedTime > INACTIVE_THRESHOLD_MS) : false;
+    const isNewVersion = lastUsedInfo.lastUsedVersion !== CURRENT_VERSION;
+    const showWelcomeCommands = isNewUser || isInactive || isNewVersion;
+    // Save/update last used info immediately
+    await saveLastUsedInfo(CURRENT_VERSION, Date.now());
     printBanner(modelToUse);
+    if (showWelcomeCommands) {
+        console.log(chalk.white.bold("  💡 Get started with interactive slash commands:"));
+        console.log(`    ${chalk.hex('#0a84ff')('/model')} ${chalk.gray('[name]')} — View active model or switch to [name]`);
+        console.log(`    ${chalk.hex('#0a84ff')('/clear')}        — Wipe conversation memory`);
+        console.log(`    ${chalk.hex('#0a84ff')('/status')}       — Show active model and memory usage`);
+        console.log(`    ${chalk.hex('#0a84ff')('/help')}         — Show help screen with configuration details`);
+        console.log(`    ${chalk.hex('#0a84ff')('/exit')}         — Exit Coder`);
+        console.log();
+    }
     rl = readline.createInterface({
         input: process.stdin,
         output: process.stdout,
         terminal: true,
     });
+    process.stdin.on("keypress", (char, key) => {
+        if (isHijacked || !rl)
+            return;
+        setImmediate(() => {
+            if (rl && rl.line === "/") {
+                console.log();
+                console.log(chalk.dim("  Available Commands:"));
+                console.log(`  ${chalk.hex('#0a84ff')('/model')} ${chalk.gray('[name]')} ${chalk.dim('— View active model or switch to [name]')}`);
+                console.log(`  ${chalk.hex('#0a84ff')('/clear')}        ${chalk.dim('— Wipe conversation memory')}`);
+                console.log(`  ${chalk.hex('#0a84ff')('/status')}       ${chalk.dim('— Show active model and memory usage')}`);
+                console.log(`  ${chalk.hex('#0a84ff')('/help')}         ${chalk.dim('— Show help screen')}`);
+                console.log(`  ${chalk.hex('#0a84ff')('/exit')}         ${chalk.dim('— Exit Coder')}`);
+                console.log();
+                rl._refreshLine();
+            }
+        });
+    });
     let inputBuffer = "";
     let pasteTimeout = null;
     let lineCountInBurst = 0;

package/dist/memory.js

@@ -315,7 +315,7 @@ export async function loadAgentMemoryPrompt(agentType, scope) {
                 }
                 catch {
                     // Create default template
-                    const defaultTemplate = `# Persistent Agent Memory\n\nUse this section to write general rules, project setup details, style preferences, or learnings. Update this file using your write_file/patch_file tools to persist memories.\n\n## Learnings & Guidelines\n- (No memories stored yet. Add your learnings here.)\n`;
+                    const defaultTemplate = `# Persistent Agent Memory\n\nUse this section to write general rules, project setup details, style preferences, or learnings. Update this file using your write_file/patch_file tools to persist memories.\n\n## Learnings & Guidelines\n- (No memories stored yet. Add your learnings here.)\n\n## File-to-Data Map\n- (List of files and what data/logic they contain. This helps the agent know what file has what data.)\n`;
                     try {
                         await fs.writeFile(memoryFile, defaultTemplate, "utf-8");
                         memoryContent = defaultTemplate;
@@ -333,13 +333,13 @@ export async function loadAgentMemoryPrompt(agentType, scope) {
     let scopeNote = "";
     switch (scope) {
         case "user":
-            scopeNote = "- Since this memory has 'user' scope, keep learnings general since they apply across all of the user's projects.";
+            scopeNote = "- Since this memory has 'user' scope, keep learnings and cataloging general since they apply across all of the user's projects.";
             break;
         case "project":
-            scopeNote = "- Since this memory has 'project' scope and is shared with the team via version control, tailor memories specifically to this project.";
+            scopeNote = "- Since this memory has 'project' scope and is shared with the team via version control, tailor memories and file cataloging specifically to this project.";
             break;
         case "local":
-            scopeNote = "- Since this memory has 'local' scope (not checked into version control), tailor memories specifically to this machine and project.";
+            scopeNote = "- Since this memory has 'local' scope (not checked into version control), tailor memories and file cataloging specifically to this machine and project.";
             break;
     }
     return `
@@ -349,8 +349,9 @@ This memory is loaded at the start of every session and injected into your syste
 
 ### Guidelines for Memory Usage:
 1. Read the memory contents below to see existing learnings, project instructions, or user preferences.
-2. If you learn something new that would be useful for future sessions (e.g., build commands, package quirks, style guidelines, API details, tool workarounds), update this file directly using your \`write_file\` or \`patch_file\` tools targeting the file path: \`${memoryFile}\`.
-3. Keep the content concise, clean, and organized.
+2. Refer to the '## File-to-Data Map' section to quickly find which files contain what data, features, logic, or configurations.
+3. If you learn something new that would be useful for future sessions (e.g., build commands, package quirks, style guidelines, API details, tool workarounds), or if you create/modify files, update this file directly using your \`write_file\` or \`patch_file\` tools targeting the file path: \`${memoryFile}\`.
+4. Keep the content concise, clean, and organized.
 ${scopeNote}
 
 ### Current Memory Contents:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coder-agent",
-  "version": "2.7.3",
+  "version": "2.8.1",
   "description": "CLI coding agent powered by Google Gemini",
   "type": "module",
   "main": "dist/index.js",