letmecook 0.0.6 → 0.0.12

package/README.md

@@ -1,6 +1,20 @@
 # letmecook
 
-Multi-repo workspace manager for AI coding sessions. Clone multiple GitHub repos into a persistent session and launch opencode with an interactive TUI.
+Ephemeral workspaces for AI coding sessions.
+
+## Why
+
+There's a common practice where developers point their AI coding agent at their development folder. This seems convenient, but that folder is often full of traps: outdated code, abandoned experiments, multiple versions of similar projects, and naming collisions that send agents down rabbit holes until they hit context limits.
+
+You have to know every file you have, which ones matter, and which ones to avoid. It's too much overhead, and your agent pays the price.
+
+**letmecook takes a different approach.** Instead of trying to control your agent with elaborate rules and constraints, give it clean context and get out of its way. Clone the repos you need, add your skills, do the work, and nuke the session when you're done.
+
+This tool is intentionally simple. It sets up repositories, skills, and soon MCP servers - then hands off to your preferred coding agent. That's it. The philosophy is that agents are good at problem-solving when you give them what they need and let them cook.
+
+**Works with any tool that can open a folder.** If your editor or agent supports `<cmd> <folder>`, it works with letmecook. opencode, Cursor, Claude Code, Codex, Gemini, VS Code, vim - whatever you prefer.
+
+[Read more about the philosophy behind letmecook](/docs/docs/concepts/philosophy.md)
 
 ## Features
 

package/index.ts

@@ -21,6 +21,7 @@ Usage:
   letmecook --resume <session-name>            Resume a session
   letmecook --nuke <session-name>              Delete a session
   letmecook --nuke-all                         Delete all sessions
+  letmecook --why                              Show why this tool exists
   letmecook --help                             Show this help
   letmecook --version                          Show version
 
@@ -35,6 +36,17 @@ Examples:
   `);
 }
 
+function printWhy(): void {
+  console.log(`
+Your dev folder is full of traps: outdated code, abandoned experiments, naming
+collisions that send agents down rabbit holes until they hit context limits.
+
+letmecook gives your agent clean context. Clone what you need, cook, nuke when done.
+
+Agents are good at problem-solving when you give them what they need and let them cook.
+  `);
+}
+
 async function handleNewSessionCLI(repos: RepoSpec[]): Promise<void> {
   const renderer = await createRenderer();
 
@@ -227,6 +239,11 @@ if (firstArg === "--version" || firstArg === "-v") {
   process.exit(0);
 }
 
+if (firstArg === "--why") {
+  printWhy();
+  process.exit(0);
+}
+
 if (args.length === 0 || firstArg === "--help" || firstArg === "-h") {
   printUsage();
   process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "letmecook",
-  "version": "0.0.6",
+  "version": "0.0.12",
   "repository": {
     "type": "git",
     "url": "https://github.com/rustydotwtf/letmecook.git"