clisbot 0.1.39 → 0.1.41

package/README.md

@@ -40,6 +40,24 @@ The challenge is not whether AI is useful. It is how to make it work at enterpri
 - Slack and Telegram are not treated as plain-text sinks: routed conversations can carry thread or topic identity, pairing, and file-aware workflows.
 - Advanced multi-agent setup is available later, but it is not required for day one.
 
+## CLI Compatibility Snapshot
+
+`clisbot` currently works best with `codex`.
+
+`claude` and `gemini` are both usable, but they need a bit more operator awareness today.
+
+| CLI      | Current Stability   | Short Take                                                                                                  |
+| ----------| ---------------------| -------------------------------------------------------------------------------------------------------------|
+| `codex`  | Best today          | Strongest default for routed coding work.                                                                   |
+| `claude` | Usable with caveats | Claude can surface its own plan-approval and auto-mode behavior even when launched with bypass-permissions. |
+| `gemini` | Usable with caveats | Runner support is solid, but auth/setup gating and routed reply behavior still need more care.              |
+
+CLI-specific operator notes:
+
+- [Codex CLI Guide](docs/user-guide/codex-cli.md)
+- [Claude CLI Guide](docs/user-guide/claude-cli.md)
+- [Gemini CLI Guide](docs/user-guide/gemini-cli.md)
+
 ## Quick Start
 
 Platform support:
@@ -61,14 +79,16 @@ clisbot start \
 
 If you want to try first without persisting the token yet, just remove `--persist`.
 
-Current auth note:
+Next steps:
 
-- DMs currently start in pairing mode by default.
-- If no app owner is configured yet, the first DM user during the first `ownerClaimWindowMinutes` becomes app `owner` automatically and does not need pairing approval.
-- Today, if you want an owner or app admin, grant that principal explicitly with the platform prefix plus the channel-native user id, for example `telegram:1276408333` or `slack:U123ABC456`.
-- Example commands:
-  - `clisbot auth add-user app --role owner --user telegram:1276408333`
-  - `clisbot auth add-user app --role admin --user slack:U123ABC456`
+- For security, just as openclaw, direct message with the bot currently requires pairing and groups need explicit specified in allowlist by default.
+- However, `clisbot` has smart autopairing feature to help you get started frictionless. Just send direct message to your bot (through telegram or slack) within 30 minutes so you can claim owner role automatically, and use the bot right away without pairing. After this 30 minutes window you need to approve pairing following instructions by the bot in direct message.
+- To chat with the bot in a group:
+  - telegram: Add bot to group, then use slash command in that group /start, you will be guided with command to add a group. Run that command directly or copy that command and chat directly with the bot in DM to ask it do for you (since you are the owner, you are authorized to run that command). After completed, come back to the group and start talk with the bot. 
+  - Notice that group has require mention (or tag the bot) enabled by default to avoid abuse. But it also has smart follow up within 5 minutes by default so you dont need to tag it again. You could change the mode by asking the bot to do for you.
+  - For long running task such as coding, you might want to toggle streaming mode on with slash command inside the chat "/streaming on", check streaming status anytime with "/streaming status". In slack, native slash command is unconventional so you can get around to use slash command with a space prefix such as " /streaming on", or use alias "\streaming on". This is also true for any other slash command supported by `clisbot`. 
+  - slack: 
+- If you want to add more owner or app admin, grant that principal explicitly with the platform prefix plus the channel-native user id, for example `clisbot auth add-user app --role owner --user telegram:1276408333` or `clisbot auth add-user app --role admin --user slack:U123ABC456`.
 - `clisbot auth --help` now covers role scopes, permission sets, and add/remove flows for users and permissions.
 - App-level auth and owner-claim semantics in [Authorization And Roles](docs/user-guide/auth-and-roles.md) describe both the current runtime reality and the remaining target-model gaps.
 
@@ -76,6 +96,7 @@ Need the step-by-step setup docs instead of the shortest path?
 
 - Telegram: [Telegram Bot Setup](docs/user-guide/telegram-setup.md)
 - Slack: [Slack App Setup](docs/user-guide/slack-setup.md)
+- Release notes: [CHANGELOG.md](CHANGELOG.md) and [docs/releases/](docs/releases/README.md)
 - Slack app manifest template: [app-manifest.json](templates/slack/default/app-manifest.json)
 - Slack app manifest guide: [app-manifest-guide.md](templates/slack/default/app-manifest-guide.md)
 
@@ -88,6 +109,20 @@ What happens next:
 - fresh bootstrap only enables the channels you name explicitly
 - after the persisted first run, later restarts can use plain `clisbot start`
 
+## Big Upgrades In v0.1.39
+
+- Much better native Slack and Telegram rendering, so replies are easier to read and feel far less like pasted terminal output.
+- A much cleaner first-run path, with a clearer bot-first setup story and better setup docs.
+- Stronger pairing, auth, and safer shared-channel behavior by default.
+- More trustworthy long-running work, with better attach, detach, recovery, and operator visibility.
+- Real recurring automation with `/loop`.
+
+Read the full notes here:
+
+- [CHANGELOG.md](CHANGELOG.md)
+- [Release Notes Index](docs/releases/README.md)
+- [v0.1.39 Release Notes](docs/releases/v0.1.39.md)
+
 If you prefer Slack first:
 
 ```bash
@@ -113,6 +148,19 @@ bun run start --cli codex --bot-type personal --telegram-bot-token <your-telegra
 
 Repo-local `bun run start|stop|restart|status|logs|init|pairing` is pinned by `.env` to `CLISBOT_HOME=~/.clisbot-dev`, so local testing does not accidentally reuse your main `~/.clisbot` runtime.
 
+Upgrade note for existing installs:
+
+- `v0.1.39` includes breaking changes in config shape and in the main CLI command surface.
+- If you already run an older install, ask Codex or Claude in this repo to update your current config before upgrading.
+- The upgrade itself is still simple:
+
+```bash
+clisbot stop
+npm install -g clisbot
+clisbot start
+clisbot --version
+```
+
 First conversation path:
 
 - send a DM to the bot in Slack or Telegram

package/config/clisbot.json.template

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "schemaVersion": "0.1.39",
+    "schemaVersion": "0.1.41",
     "lastTouchedAt": "2026-04-18T10:10:00Z"
   },
   "app": {
@@ -127,7 +127,7 @@
           "loadingMessages": []
         },
         "directMessages": {
-          "*": {
+          "dm:*": {
             "enabled": true,
             "requireMention": false,
             "policy": "pairing",
@@ -192,7 +192,7 @@
         },
         "timezone": "UTC",
         "directMessages": {
-          "*": {
+          "dm:*": {
             "enabled": true,
             "requireMention": false,
             "policy": "pairing",
@@ -224,14 +224,12 @@
             },
             "timezone": "America/Los_Angeles"
           },
-          "U_OWNER": {
-            "enabled": true,
-            "policy": "open",
+          "dm:U_OWNER": {
             "agentId": "default"
           }
         },
         "groups": {
-          "*": {
+          "dm:*": {
             "enabled": true,
             "requireMention": true,
             "policy": "disabled",
@@ -361,14 +359,12 @@
               "participationTtlMin": 10
             }
           },
-          "U_SUPPORT": {
-            "enabled": true,
-            "policy": "allowlist",
+          "dm:U_SUPPORT": {
             "agentId": "reviewer"
           }
         },
         "groups": {
-          "*": {
+          "dm:*": {
             "enabled": true,
             "requireMention": true,
             "policy": "disabled",
@@ -450,7 +446,7 @@
         },
         "timezone": "UTC",
         "directMessages": {
-          "*": {
+          "dm:*": {
             "enabled": true,
             "requireMention": false,
             "policy": "pairing",
@@ -525,14 +521,12 @@
               "participationTtlMin": 5
             }
           },
-          "1276408333": {
-            "enabled": true,
-            "policy": "open",
+          "dm:1276408333": {
             "agentId": "default"
           }
         },
         "groups": {
-          "*": {
+          "dm:*": {
             "enabled": true,
             "requireMention": true,
             "policy": "disabled",
@@ -664,14 +658,10 @@
               "participationTtlMin": 15
             }
           },
-          "1276408333": {
-            "enabled": true,
-            "policy": "open",
+          "dm:1276408333": {
             "agentId": "reviewer"
           },
-          "555000111": {
-            "enabled": true,
-            "policy": "open",
+          "dm:555000111": {
             "agentId": "reviewer"
           }
         },

package/config/clisbot.json.v0.1.39.template

@@ -685,7 +685,7 @@
       "workspace": "~/.clisbot/workspaces/{agentId}",
       "cli": "codex",
       "bootstrap": {
-        "botType": "team"
+        "botType": "team-assistant"
       },
       "runner": {
         "defaults": {