@openclawcity/become 1.0.6 → 1.0.8

package/README.md

@@ -16,16 +16,17 @@ Install become. It sits between your agent and its LLM. When your agent talks to
 
 ---
 
-## 3 commands. That's it.
+## 2 commands. That's it.
 
 ```bash
 npm install -g @openclawcity/become
 
 become setup     # wizard: which agent? which LLM? API key?
-become start     # proxy + dashboard start
-become on        # your agent now learns from other agents
+become start     # proxy starts, agent connects, learning begins
 ```
 
+`become start` does everything: starts the proxy, connects your agent, opens the dashboard. Ctrl+C to stop (automatically disconnects your agent).
+
 ---
 
 ## How it works
@@ -91,13 +92,15 @@ Your agent now uses IEEE citations. Not because you told it to — because anoth
 
 ## Turn it on and off
 
+`become start` auto-connects your agent. Ctrl+C auto-disconnects. If you need manual control from a separate terminal:
+
 ```bash
 become on        # agent routes through proxy, learns from others
 become off       # agent talks directly to LLM, no proxy
 become status    # shows ON/OFF, skill count, pending count
 ```
 
-When off, your agent goes straight to the LLM. Zero overhead. Learned skills stay on disk — they're injected again when you turn it back on.
+When off, your agent goes straight to the LLM. Zero overhead. Learned skills stay on disk and are injected again when you start become next time.
 
 ---
 
@@ -124,7 +127,7 @@ Open `http://localhost:30002` when the proxy is running.
 | **Review queue** | Every lesson goes to pending first. You approve or reject. |
 | **Trust levels** | Trusted = auto-approve. Pending = manual review. Blocked = silently ignored. |
 | **Rate limits** | Max 20 lessons/day, max 10 per agent. Configurable. |
-| **On/off switch** | `become off` — your agent bypasses the proxy completely. |
+| **On/off switch** | Ctrl+C stops everything and auto-disconnects. `become off` from another terminal also works. |
 | **Local only** | Everything stored in `~/.become/` on your machine. |
 | **No data sent** | become never phones home. Only talks to the LLM you configured. |
 | **Open source** | MIT license. 492 tests. |
@@ -190,8 +193,11 @@ Yes. Streaming responses are piped through unchanged.
 **Can I use a different LLM for extraction?**
 Yes. The LLM that analyzes conversations can be different from your agent's LLM.
 
+**How do I stop it?**
+Ctrl+C in the terminal where `become start` is running. This stops the proxy and automatically restores your agent's original LLM config.
+
 **What if I want to reset everything?**
-`become off` restores your agent's original config. Delete `~/.become/` to remove all data.
+Stop become (Ctrl+C), then `rm -rf ~/.become` to remove all data (skills, config, trust).
 
 ---
 
@@ -210,8 +216,7 @@ npm uninstall -g @openclawcity/become
 # Uninstall and remove all data (skills, config, trust, everything)
 npm uninstall -g @openclawcity/become && rm -rf ~/.become
 
-# If become was ON when you uninstall, restore your agent first
-become off          # restores original agent config
+# If become is running, stop it first (Ctrl+C), then uninstall
 npm uninstall -g @openclawcity/become
 ```
 

package/dist/cli.cjs

@@ -1574,6 +1574,13 @@ async function start() {
     }
   });
   await dashboard.listen(config.dashboard_port);
+  if (config.state !== "on") {
+    try {
+      turnOn();
+    } catch (e) {
+      console.error("Warning: could not auto-connect agent:", e instanceof Error ? e.message : e);
+    }
+  }
   const approved = proxy.store.listApproved().length;
   const pending = proxy.store.listPending().length;
   const trustConfig = proxy.trust.getConfig();
@@ -1583,14 +1590,15 @@ become proxy running on localhost:${config.proxy_port}`);
   console.log(`
 Skills loaded: ${approved} approved, ${pending} pending`);
   console.log(`Trust rules: ${trustConfig.trusted.length} trusted, ${trustConfig.blocked.length} blocked`);
-  if (config.state === "on") {
-    console.log("\nProxy is ACTIVE \u2014 your agent is learning from other agents.");
-  } else {
-    console.log("\nProxy is IDLE \u2014 run `become on` to route your agent through become.");
-  }
-  console.log("Use `become off` to disconnect. Ctrl+C to stop.\n");
+  console.log("\nYour agent is learning from other agents.");
+  console.log("Dashboard: http://localhost:" + config.dashboard_port);
+  console.log("Ctrl+C to stop.\n");
   const shutdown = async () => {
     console.log("\nShutting down...");
+    try {
+      turnOff();
+    } catch {
+    }
     await Promise.all([proxy.close(), dashboard.close()]);
     process.exit(0);
   };