meshcode 2.10.40__tar.gz → 2.10.42__tar.gz

{meshcode-2.10.40 → meshcode-2.10.42}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshcode
-Version: 2.10.40
+Version: 2.10.42
 Summary: Real-time communication between AI agents — Supabase-backed CLI
 Author-email: MeshCode <hello@meshcode.io>
 License: MIT
@@ -400,10 +400,32 @@ meshcode projects                       # lists all your meshworks
 **8. Unknown command (e.g., `meshcode list`)**
 Since v2.0.2, the CLI suggests the closest match instead of dumping the full help text. Common aliases: `list` and `ls` both work for `projects`.
 
-**5. `MCP server failed to start` in the Claude Code `/mcp` panel**
+**9. Windows: agent registers but never appears online**
+On Windows, especially with Python 3.14+, you may see `ImportError` crashes or agents that register but stay offline. This was fixed in v2.10.40. Upgrade first:
+```bash
+pip install meshcode --upgrade
+```
+If the agent still fails after upgrading, check that your `.mcp.json` command path is valid. On Windows, the MCP config should use `python` (not `python3`, which doesn't exist on Windows):
+```json
+{
+  "command": "python",
+  "args": ["-m", "meshcode_mcp", "serve"]
+}
+```
+If `meshcode setup` was run from a conda/venv environment that no longer exists, the baked path in `.mcp.json` will be stale. Re-run `meshcode setup <project> <agent>` from your current Python environment to fix it.
+
+As a fast-path workaround, you can set `MESHCODE_PROJECT_ID` as an environment variable to bypass the project name lookup at boot (which can fail on Windows due to RLS visibility):
+```bash
+set MESHCODE_PROJECT_ID=your-project-uuid   # Windows cmd
+$env:MESHCODE_PROJECT_ID="your-project-uuid"  # Windows PowerShell
+```
+
+You can also run `meshcode doctor` (v2.10.41+) to diagnose stale paths, missing dependencies, and config issues across all your workspaces.
+
+**10. `MCP server failed to start` in the Claude Code `/mcp` panel**
 Run `claude --debug` to see the underlying error. Nine times out of ten it's a stale or missing key — run `meshcode login mc_xxx` again.
 
-**6. PyPI says `Could not find version 1.x.x` immediately after a publish**
+**11. PyPI says `Could not find version 1.x.x` immediately after a publish**
 CDN propagation. Wait ~60s and force-fetch directly from the origin:
 ```bash
 pip install --no-cache-dir -i https://pypi.org/simple/ meshcode

{meshcode-2.10.40 → meshcode-2.10.42}/README.md

@@ -374,10 +374,32 @@ meshcode projects                       # lists all your meshworks
 **8. Unknown command (e.g., `meshcode list`)**
 Since v2.0.2, the CLI suggests the closest match instead of dumping the full help text. Common aliases: `list` and `ls` both work for `projects`.
 
-**5. `MCP server failed to start` in the Claude Code `/mcp` panel**
+**9. Windows: agent registers but never appears online**
+On Windows, especially with Python 3.14+, you may see `ImportError` crashes or agents that register but stay offline. This was fixed in v2.10.40. Upgrade first:
+```bash
+pip install meshcode --upgrade
+```
+If the agent still fails after upgrading, check that your `.mcp.json` command path is valid. On Windows, the MCP config should use `python` (not `python3`, which doesn't exist on Windows):
+```json
+{
+  "command": "python",
+  "args": ["-m", "meshcode_mcp", "serve"]
+}
+```
+If `meshcode setup` was run from a conda/venv environment that no longer exists, the baked path in `.mcp.json` will be stale. Re-run `meshcode setup <project> <agent>` from your current Python environment to fix it.
+
+As a fast-path workaround, you can set `MESHCODE_PROJECT_ID` as an environment variable to bypass the project name lookup at boot (which can fail on Windows due to RLS visibility):
+```bash
+set MESHCODE_PROJECT_ID=your-project-uuid   # Windows cmd
+$env:MESHCODE_PROJECT_ID="your-project-uuid"  # Windows PowerShell
+```
+
+You can also run `meshcode doctor` (v2.10.41+) to diagnose stale paths, missing dependencies, and config issues across all your workspaces.
+
+**10. `MCP server failed to start` in the Claude Code `/mcp` panel**
 Run `claude --debug` to see the underlying error. Nine times out of ten it's a stale or missing key — run `meshcode login mc_xxx` again.
 
-**6. PyPI says `Could not find version 1.x.x` immediately after a publish**
+**11. PyPI says `Could not find version 1.x.x` immediately after a publish**
 CDN propagation. Wait ~60s and force-fetch directly from the origin:
 ```bash
 pip install --no-cache-dir -i https://pypi.org/simple/ meshcode

{meshcode-2.10.40 → meshcode-2.10.42}/meshcode/__init__.py

@@ -1,2 +1,2 @@
 """MeshCode — Real-time communication between AI agents."""
-__version__ = "2.10.40"
+__version__ = "2.10.42"

{meshcode-2.10.40 → meshcode-2.10.42}/meshcode/comms_v4.py

@@ -74,7 +74,11 @@ SUPABASE_KEY = os.environ.get("SUPABASE_KEY") or _env_file.get("SUPABASE_KEY") o
 SCHEMA = "meshcode"
 
 # Local paths for session/TTY tracking (still needed for nudge)
-COMMS_DIR = Path(__file__).parent
+# NEVER use Path(__file__).parent — writing into the package directory
+# creates residual files that turn site-packages/meshcode/ into a
+# namespace package, breaking editable installs and __version__ imports.
+COMMS_DIR = Path.home() / ".meshcode"
+COMMS_DIR.mkdir(parents=True, exist_ok=True)
 SESSIONS_DIR = COMMS_DIR / "sessions"
 LOG_FILE = COMMS_DIR / "comms.log"
 
@@ -310,29 +314,39 @@ def mark_nudged(project, name):
         nf.write_text(str(time.time()), encoding="utf-8")
 
 
+def _sanitize_notification_text(text: str) -> str:
+    """Strip characters that could escape shell/PS quoting contexts."""
+    # Remove quotes, backticks, dollar signs, semicolons, pipes, and backslashes
+    # to prevent injection in osascript, PowerShell, and notify-send.
+    return "".join(c for c in text if c not in '"\'`$;|\\<>(){}')
+
+
 def send_notification(project, name, from_agent, pending=1):
     """Cross-platform notification: macOS (osascript), Windows (PowerShell toast), Linux (notify-send)."""
-    title = f"MeshCode [{project}] → {name}"
-    body = f"{pending} mensaje(s) pendiente(s) de {from_agent}"
+    title = _sanitize_notification_text(f"MeshCode [{project}] → {name}")
+    body = _sanitize_notification_text(f"{pending} mensaje(s) pendiente(s) de {from_agent}")
     try:
         if sys.platform == "darwin":
+            # osascript: pass as -e argument, quotes are stripped by sanitizer
             subprocess.run(['osascript', '-e',
                 f'display notification "{body}" with title "{title}" sound name "Ping"'],
                 capture_output=True, timeout=3)
         elif sys.platform == "win32":
+            # PowerShell: use single-quoted strings (no variable expansion)
+            # and pass title/body via -replace to avoid any interpolation
             ps_script = (
-                f'[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] | Out-Null; '
-                f'$xml = [Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent(0); '
-                f'$text = $xml.GetElementsByTagName("text"); '
-                f'$text[0].AppendChild($xml.CreateTextNode("{title}")); '
-                f'$text[1].AppendChild($xml.CreateTextNode("{body}")); '
-                f'$toast = [Windows.UI.Notifications.ToastNotification]::new($xml); '
-                f'[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier("MeshCode").Show($toast)'
+                '[Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] | Out-Null; '
+                '$xml = [Windows.UI.Notifications.ToastNotificationManager]::GetTemplateContent(0); '
+                '$text = $xml.GetElementsByTagName("text"); '
+                f"$text[0].AppendChild($xml.CreateTextNode('{title}')); "
+                f"$text[1].AppendChild($xml.CreateTextNode('{body}')); "
+                '$toast = [Windows.UI.Notifications.ToastNotification]::new($xml); '
+                '[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier("MeshCode").Show($toast)'
             )
-            subprocess.run(['powershell', '-Command', ps_script],
+            subprocess.run(['powershell', '-NoProfile', '-Command', ps_script],
                 capture_output=True, timeout=5)
         else:
-            # Linux
+            # Linux: notify-send takes title and body as separate args (no shell)
             subprocess.run(['notify-send', title, body], capture_output=True, timeout=3)
     except (subprocess.TimeoutExpired, subprocess.SubprocessError, OSError):
         pass
@@ -343,9 +357,26 @@ def _is_pid_alive(pid):
     if not pid:
         return False
     try:
-        os.kill(int(pid), 0)
+        pid = int(pid)
+    except (ValueError, TypeError):
+        return False
+    if sys.platform == "win32":
+        # os.kill(pid, 0) doesn't work on Windows — use kernel32 OpenProcess
+        try:
+            import ctypes
+            PROCESS_QUERY_LIMITED_INFORMATION = 0x1000
+            handle = ctypes.windll.kernel32.OpenProcess(
+                PROCESS_QUERY_LIMITED_INFORMATION, False, pid)
+            if handle:
+                ctypes.windll.kernel32.CloseHandle(handle)
+                return True
+            return False
+        except Exception:
+            return False
+    try:
+        os.kill(pid, 0)
         return True
-    except (OSError, ValueError, TypeError):
+    except OSError:
         return False
 
 
@@ -533,7 +564,7 @@ def spawn_headless_agent(project, name, project_id, message_body, from_agent):
         f"{message_body}\n\n"
         f"Recent mesh activity:\n{history_text or '(none)'}\n\n"
         "Process the message. If you need to reply, use this exact bash command (one line):\n"
-        f"  SUPABASE_URL=\"$SUPABASE_URL\" SUPABASE_KEY=\"$SUPABASE_KEY\" python3 ~/Desktop/meshcode/comms_v4.py send {project} {name}:{from_agent} '<json_response>'\n\n"
+        f"  {sys.executable} -m meshcode send {project} {name}:{from_agent} '<json_response>'\n\n"
         "Then exit. Do not start a long conversation."
     )
 
@@ -579,7 +610,8 @@ def spawn_headless_agent(project, name, project_id, message_body, from_agent):
         claude_bin = _find_claude()
         # Augment PATH so any subprocess the agent itself spawns (git, npm,
         # python3, supabase CLI, etc.) can find common tools.
-        env["PATH"] = "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:" + env.get("PATH", "")
+        if sys.platform != "win32":
+            env["PATH"] = "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:" + env.get("PATH", "")
         result = subprocess.run(
             [claude_bin, "--print", "--dangerously-skip-permissions",
              "--append-system-prompt", system_prompt, message_body or ""],
@@ -959,12 +991,34 @@ def register(project, name, role=""):
     log_msg(f"{name} joined {project} (tty={tty}, backend=supabase)")
 
 
+def _resolve_agent_name(project_id, name):
+    """Resolve partial agent name to full registered name."""
+    if not name or name == "*":
+        return name
+    agents = sb_select("mc_agents", f"project_id=eq.{project_id}", limit=50)
+    if not agents:
+        return name
+    all_names = [a["name"] for a in agents]
+    if name in all_names:
+        return name
+    prefix = [n for n in all_names if n.startswith(name)]
+    if len(prefix) == 1:
+        return prefix[0]
+    sub = [n for n in all_names if name in n]
+    if len(sub) == 1:
+        return sub[0]
+    return name
+
+
 def send_msg(project, from_agent, to_agent, content, msg_type="msg", compact=False):
     project_id = get_project_id(project)
     if not project_id:
         print(f"[ERROR] Proyecto '{project}' no encontrado")
         return
 
+    # Resolve partial agent names
+    to_agent = _resolve_agent_name(project_id, to_agent)
+
     payload = {}
     try:
         payload = json.loads(content)
@@ -1026,7 +1080,7 @@ def broadcast(project, from_agent, content, msg_type="broadcast"):
     print(f"[{project}] broadcast from {from_agent} -> {count} agents")
 
 
-def read_messages(project, name, silent=False):
+def read_messages(project, name, silent=False, send_acks=True):
     project_id = get_project_id(project)
     if not project_id:
         if not silent:
@@ -1064,21 +1118,68 @@ def read_messages(project, name, silent=False):
             ack_targets.add(sender)
     print("---")
 
-    # Send automatic ACKs
-    for sender in ack_targets:
-        ack_payload = {"text": f"{name} read your message"}
-        sb_insert("mc_messages", {
-            "project_id": project_id,
-            "from_agent": name,
-            "to_agent": sender,
-            "type": "ack",
-            "payload": ack_payload,
-            "read": False
-        })
+    # Send automatic ACKs (skip when called from watch to avoid ack spam)
+    if send_acks:
+        for sender in ack_targets:
+            ack_payload = {"text": f"{name} read your message"}
+            sb_insert("mc_messages", {
+                "project_id": project_id,
+                "from_agent": name,
+                "to_agent": sender,
+                "type": "ack",
+                "payload": ack_payload,
+                "read": True
+            })
 
     return messages
 
 
+def inbox(project, name):
+    """All-in-one: show agent status, pending count, tasks, and read new messages."""
+    project_id = get_project_id(project)
+    if not project_id:
+        print(f"[meshcode] Project '{project}' not found")
+        return
+
+    # Agent status
+    agent_rows = sb_select("mc_agents",
+        f"project_id=eq.{project_id}&name=eq.{quote(name)}", limit=1)
+    if agent_rows:
+        a = agent_rows[0]
+        print(f"[{project}] {name} | status: {a.get('status', '?')} | task: {a.get('task', '-')}")
+    else:
+        print(f"[{project}] {name} (not registered)")
+
+    # Pending messages
+    pending = sb_select("mc_messages",
+        f"project_id=eq.{project_id}&to_agent=eq.{quote(name)}&read=eq.false&type=neq.ack",
+        order="created_at.asc")
+    if pending:
+        print(f"\n  {len(pending)} unread message(s):")
+        for msg in pending:
+            sender = msg["from_agent"]
+            ts = msg.get("created_at", "")
+            if "T" in ts:
+                ts = ts.replace("T", " ")[:19]
+            payload = msg.get("payload", {})
+            preview = json.dumps(payload, ensure_ascii=False)[:100]
+            print(f"    [{ts}] {sender}: {preview}")
+        # Ask if they want to read (mark as read)
+        print(f"\n  Run `meshcode read {project} {name}` to read and mark as read.")
+    else:
+        print("  No unread messages.")
+
+    # Open tasks assigned to this agent
+    tasks = sb_select("mc_tasks",
+        f"project_id=eq.{project_id}&assignee=eq.{quote(name)}&status=neq.done&status=neq.canceled",
+        order="created_at.desc", limit=5)
+    if tasks:
+        print(f"\n  {len(tasks)} open task(s):")
+        for t in tasks:
+            print(f"    [{t.get('priority', '?')}] {t.get('title', '?')} ({t.get('status', '?')})")
+    print()
+
+
 def hook_check():
     """Called by PostToolUse hook. Auto-detects project+agent, prints pending.
     Also sends heartbeat so dashboard always shows fresh status."""
@@ -1127,7 +1228,10 @@ def watch(project, name, interval=10, timeout=0):
             f"project_id=eq.{project_id}&name=eq.{quote(name)}",
             {"status": "online", "task": "Listening to user", "last_heartbeat": now_iso()})
         sys.exit(0)
-    signal.signal(signal.SIGINT, handle_interrupt)
+    try:
+        signal.signal(signal.SIGINT, handle_interrupt)
+    except ValueError:
+        pass  # Non-main thread (Windows restriction)
 
     # Update status to standby
     sb_update("mc_agents",
@@ -1148,13 +1252,18 @@ def watch(project, name, interval=10, timeout=0):
             if pending:
                 elapsed = int(time.time() - start)
                 print(f"\n*** [{project.upper()}] MENSAJE RECIBIDO ({elapsed}s en standby) ***")
-                messages = read_messages(project, name, silent=False)
+                read_messages(project, name, silent=False, send_acks=False)
 
                 sb_update("mc_agents",
                     f"project_id=eq.{project_id}&name=eq.{quote(name)}",
                     {"status": "working", "task": "Procesando mensaje recibido", "last_heartbeat": now_iso()})
 
-                return messages
+                # Reset to standby and keep polling (don't exit the loop)
+                time.sleep(2)
+                sb_update("mc_agents",
+                    f"project_id=eq.{project_id}&name=eq.{quote(name)}",
+                    {"status": "standby", "task": "Waiting for messages...", "last_heartbeat": now_iso()})
+                continue
 
             # Heartbeat
             sb_rpc("mc_heartbeat", {"p_project_id": project_id, "p_agent_name": name})
@@ -1181,7 +1290,7 @@ def update_board(project, name, status, task=""):
             count = len(sb_select("mc_messages",
                 f"project_id=eq.{project_id}&to_agent=eq.{quote(name)}&read=eq.false&type=neq.ack"))
             print(f"[{project}] {name}: NO puedes estar idle — tienes {count} mensaje(s) pendientes.")
-            print(f"[{project}] Ejecuta: python3 ~/Desktop/meshcode/comms_v4.py read {project} {name}")
+            print(f"[{project}] Ejecuta: {sys.executable} -m meshcode read {project} {name}")
             status = "working"
             task = f"{count} pending messages"
 
@@ -1215,13 +1324,21 @@ def show_board(project):
 
 
 def show_status(project=None):
-    if project:
+    # Try API-key-authenticated RPC first (RLS may block anon SELECT)
+    api_key = _load_api_key_for_cli()
+    if api_key and not project:
+        rpc_data = sb_rpc("mc_list_user_projects", {"p_api_key": api_key})
+        if isinstance(rpc_data, dict) and not rpc_data.get("error"):
+            projects_data = rpc_data.get("projects", [])
+        else:
+            projects_data = sb_select("mc_projects", "", order="created_at.asc")
+    elif project:
         projects_data = sb_select("mc_projects", f"name=eq.{quote(project)}")
     else:
         projects_data = sb_select("mc_projects", "", order="created_at.asc")
 
     if not projects_data:
-        print("[COMMS] No active projects")
+        print("[meshcode] No projects found. Try `meshcode projects` or `meshcode login <api_key>` first.")
         return
 
     print(f"\n{'='*60}")
@@ -1398,7 +1515,7 @@ def _start_heartbeat_daemon(project, name):
         if pid_file.exists():
             old = int(pid_file.read_text(encoding="utf-8").strip())
             try:
-                os.kill(old, 15)
+                _terminate_pid(old)
             except Exception:
                 pass
     except Exception:
@@ -1450,12 +1567,21 @@ def _start_heartbeat_daemon(project, name):
     return proc.pid
 
 
+def _terminate_pid(pid):
+    """Terminate a process by PID, cross-platform."""
+    if sys.platform == "win32":
+        subprocess.run(["taskkill", "/F", "/PID", str(pid)],
+                       stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
+    else:
+        os.kill(pid, 15)
+
+
 def _stop_heartbeat_daemon(project, name):
     pid_file = _heartbeat_loop_pidfile(project, name)
     if pid_file.exists():
         try:
             pid = int(pid_file.read_text(encoding="utf-8").strip())
-            os.kill(pid, 15)
+            _terminate_pid(pid)
         except Exception:
             pass
         try:
@@ -1603,19 +1729,11 @@ def connect(project, name, hook_target="claude", role=""):
         _setup_ws(project, name, actual_role)
 
     elif hook_target == "codex":
-        config_path = Path.cwd() / ".meshcode.json"
-        config = {
-            "project": project,
-            "agent": name,
-            "supabase_url": SUPABASE_URL,
-            "check_command": f"python3 {comms_path} check",
-            "read_command": f"python3 {comms_path} read {project} {name}",
-            "send_command": f"python3 {comms_path} send {project} {name}:{{to}} '{{message}}'",
-            "platform": os_name
-        }
-        config_path.write_text(json.dumps(config, indent=2), encoding="utf-8")
-        print(f"[meshcode] Config saved to {config_path}")
-        print(f"[meshcode] Codex: use read_command and send_command from the config")
+        # Codex reads ~/.codex/config.toml globally — workspace .mcp.json is ignored.
+        # Use setup_clients.setup_global to write the proper TOML config.
+        import importlib
+        _setup_global = importlib.import_module("meshcode.setup_clients").setup_global
+        _setup_global("codex", project, name, actual_role)
 
     else:
         print(f"[meshcode] Unknown hook target: {hook_target}. Use 'claude' or 'codex'.")
@@ -1629,9 +1747,10 @@ def connect(project, name, hook_target="claude", role=""):
         print(f"  3. Start using tools: meshcode_send, meshcode_read, etc.")
         print(f"  No extra terminal. No watch loops. No AppleScript.")
     else:
-        print(f"  Read:    python3 {comms_path} read {project} {name}")
-        print(f"  Send:    python3 {comms_path} send {project} {name}:<target> '<message>'")
-        print(f"  Board:   python3 {comms_path} board {project}")
+        _py = sys.executable
+        print(f"  Read:    {_py} {comms_path} read {project} {name}")
+        print(f"  Send:    {_py} {comms_path} send {project} {name}:<target> \"<message>\"")
+        print(f"  Board:   {_py} {comms_path} board {project}")
     print()
 
 
@@ -1840,6 +1959,15 @@ Show conversation history. Optionally filter to messages between two agents.
 EXAMPLES:
   meshcode history my-app 50
   meshcode history my-app 20 backend,frontend
+""",
+    "inbox": """meshcode inbox <project> <name>
+
+All-in-one overview: agent status, unread messages, and open tasks.
+Alias: meshcode next
+
+EXAMPLES:
+  meshcode inbox my-app backend
+  meshcode next my-app frontend
 """,
     "projects": """meshcode projects
 
@@ -2050,6 +2178,7 @@ if __name__ == "__main__":
         # Supports both:
         #   send <project> <from>:<to> <message>
         #   send --project X --from Y --to Z --msg "text" [--type T]
+        #   echo '{"key":"val"}' | meshcode send <project> <from>:<to> -
         compact = bool(flags.get("compact"))
         if "from" in flags and "to" in flags:
             proj = flags.get("project", pos[0] if len(pos) > 0 else "default")
@@ -2062,6 +2191,9 @@ if __name__ == "__main__":
             proj = pos[0] if len(pos) > 0 else "default"
             target = pos[1] if len(pos) > 1 else ""
             message = " ".join(pos[2:]) if len(pos) > 2 else ""
+            # Support stdin: `meshcode send proj from:to -` reads from pipe
+            if message.strip() == "-" and not sys.stdin.isatty():
+                message = sys.stdin.read().strip()
             if ":" in target:
                 from_a, to_a = target.split(":", 1)
             else:
@@ -2092,6 +2224,11 @@ if __name__ == "__main__":
         name = flags.get("name", pos[1] if len(pos) > 1 else "agent")
         read_messages(proj, name)
 
+    elif cmd in ("inbox", "next"):
+        proj = flags.get("project", pos[0] if len(pos) > 0 else "default")
+        name = flags.get("name", pos[1] if len(pos) > 1 else "agent")
+        inbox(proj, name)
+
     elif cmd == "check":
         hook_check()
 
@@ -2427,6 +2564,7 @@ if __name__ == "__main__":
 
     elif cmd == "whoami":
         # Show the logged-in user identity from profile_meta.json
+        verbose = "--verbose" in sys.argv or "-v" in sys.argv
         meta_path = Path.home() / ".meshcode" / "profile_meta.json"
         if meta_path.exists():
             try:
@@ -2441,6 +2579,25 @@ if __name__ == "__main__":
                     print(f"  user ID:      {meta['user_id']}")
                 active = os.environ.get("MESHCODE_KEYCHAIN_PROFILE") or "default"
                 print(f"  profile:      {active}")
+
+                if verbose:
+                    # Show projects, agents, plan, API key status
+                    api_key = _load_api_key_for_cli()
+                    if api_key:
+                        print(f"  api key:      {api_key[:8]}...{api_key[-4:]}")
+                        # List projects
+                        result = sb_rpc("mc_list_user_projects", {"p_api_key": api_key})
+                        if isinstance(result, dict) and result.get("ok"):
+                            projects = result.get("projects", [])
+                            print(f"\n  Projects ({len(projects)}):")
+                            for p in projects:
+                                agent_count = p.get("agent_count", "?")
+                                plan = p.get("plan", "free")
+                                print(f"    {p.get('name', '?'):20s}  plan={plan:12s}  agents={agent_count}")
+                        else:
+                            print(f"\n  Projects: (could not fetch)")
+                    else:
+                        print(f"  api key:      not found")
                 print()
             except Exception:
                 print("[meshcode] Could not read profile. Run `meshcode login <api_key>`.")
@@ -2558,7 +2715,7 @@ if __name__ == "__main__":
 
     else:
         known_cmds = [
-            "register", "send", "broadcast", "read", "check", "watch",
+            "register", "send", "broadcast", "read", "check", "watch", "inbox", "next",
             "board", "update", "status", "projects", "list", "ls",
             "history", "clear", "unregister", "connect", "disconnect",
             "setup", "run", "go", "invite", "join", "invites", "members",