clisbot 0.1.38 → 0.1.40

package/README.md

@@ -1,4 +1,4 @@
-# clisbot - Turn your favorite coding CLI into an agentic assistant and code on the go
+# clisbot - Turn your favorite coding CLI into an agentic personal assistant, workplace assistant, coding partner - on the go
 Want to use OpenClaw but are struggling because:
 
 - API cost is too high, so you end up looking for LLM proxy workarounds
@@ -76,6 +76,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 +89,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 +128,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
@@ -174,24 +202,25 @@ The docs in this repo are kept current, including the [User Guide](docs/user-gui
 
 If you prefer to configure everything yourself:
 
-1. Read the full config template in [config/clisbot.json.template](config/clisbot.json.template).
-2. Copy it to `~/.clisbot/clisbot.json` and adjust channels, bindings, workspaces, and policies for your environment.
-3. Add agents through the CLI so tool defaults, startup options, and bootstrap templates stay consistent.
-4. Optionally move stable channel secrets into env vars or canonical credential files after your first successful run.
+1. Read the official config template in [config/clisbot.json.template](config/clisbot.json.template).
+2. If you need the archived legacy snapshot, compare it with [config/clisbot.json.v0.1.0.template](config/clisbot.json.v0.1.0.template).
+3. Copy the official template to `~/.clisbot/clisbot.json` and adjust bots, routes, agents, workspaces, and policies for your environment.
+4. Add agents through the CLI so tool defaults, startup options, and bootstrap templates stay consistent.
+5. Optionally move stable channel secrets into env vars or canonical credential files after your first successful run.
 
 Channel route setup is manual by design:
 
 - fresh config does not auto-add Slack channels
 - fresh config does not auto-add Telegram groups or topics
 - add only the exact channel, group, topic, or DM routing you want to expose
-- default channel account setup lives in [docs/user-guide/channel-accounts.md](docs/user-guide/channel-accounts.md)
+- default bot credential setup lives in [docs/user-guide/bots-and-credentials.md](docs/user-guide/bots-and-credentials.md)
 
 Advanced agent management:
 
 - most users should stay on `clisbot start --cli ... --bot-type ...` and let first-run create the default agent
-- if you need more than one agent, custom bindings, or manual workspace bootstrap flows, use the `clisbot agents ...` commands described in [docs/user-guide/README.md](docs/user-guide/README.md)
+- if you need more than one agent, custom bot defaults, or manual route setup flows, use the `clisbot agents ...`, `clisbot bots ...`, and `clisbot routes ...` commands described in [docs/user-guide/README.md](docs/user-guide/README.md)
 - README intentionally keeps that low-level surface out of the main onboarding path because the public first-run model is `--bot-type personal|team`, not internal template-mode naming
-- fresh channel config still points at the `default` agent; if your first agent uses another id, update `defaultAgentId` and any route `agentId` values in config
+- fresh bot config still points at the `default` agent; if your first useful agent uses another id, update the fallback with `clisbot bots set-agent ...` or override it on a route with `clisbot routes set-agent ...`
 
 Env-backed setup is still supported when you want config to reference an env name instead of persisting a credential file:
 
@@ -206,7 +235,7 @@ clisbot start \
 - these flags are written into `~/.clisbot/clisbot.json` as `${ENV_NAME}` placeholders
 - you can pass either `CUSTOM_SLACK_APP_TOKEN` or `'${CUSTOM_SLACK_APP_TOKEN}'`
 - use this path when you want config to point at env variable names you chose yourself
-- keep env export details in [docs/user-guide/channel-accounts.md](docs/user-guide/channel-accounts.md) instead of front-loading them into quick start
+- keep env export details in [docs/user-guide/bots-and-credentials.md](docs/user-guide/bots-and-credentials.md) instead of front-loading them into quick start
 
 ## Troubleshooting
 
@@ -216,7 +245,7 @@ If the quick start does not work, check these in order:
 - If config behavior is confusing, inspect [config/clisbot.json.template](config/clisbot.json.template) first, then compare it with [docs/user-guide/README.md](docs/user-guide/README.md).
 - If `clisbot start` says no agents are configured, prefer `clisbot start --cli codex --bot-type personal --telegram-bot-token <your-telegram-bot-token>`.
 - If you want later runs to work with plain `clisbot start`, rerun your successful first-run command with `--persist`.
-- If `clisbot start` prints token refs as `missing`, either pass the token explicitly on the command line or switch to env-backed setup described in [docs/user-guide/channel-accounts.md](docs/user-guide/channel-accounts.md).
+- If `clisbot start` prints token refs as `missing`, either pass the token explicitly on the command line or switch to env-backed setup described in [docs/user-guide/bots-and-credentials.md](docs/user-guide/bots-and-credentials.md).
 - If you use custom env names, pass them explicitly with `--slack-app-token`, `--slack-bot-token`, or `--telegram-bot-token`.
 - If `clisbot status` shows `bootstrap=...:missing` or `bootstrap=...:not-bootstrapped`, follow the advanced agent bootstrap steps in [docs/user-guide/README.md](docs/user-guide/README.md).
 - If Codex shows `Do you trust the contents of this directory?`, keep `trustWorkspace: true` in clisbot config and also mark the workspace as trusted in `~/.codex/config.toml`, for example:
@@ -251,12 +280,14 @@ Most users only need a small set of commands at first:
 - `clisbot auth add-user agent --agent <id> --role admin --user <principal>`
 - `clisbot pairing approve slack <CODE>`
 - `clisbot pairing approve telegram <CODE>`
-- `clisbot channels enable slack`
-- `clisbot channels enable telegram`
-- `clisbot channels add telegram-group <chatId> [--topic <topicId>] [--agent <id>] [--require-mention true|false]`
-- `clisbot channels add slack-channel <channelId> [--agent <id>] [--require-mention true|false]`
-- `clisbot agents list --bindings`
-- `clisbot agents bindings`
+- `clisbot bots list`
+- `clisbot bots add --channel telegram --bot default --bot-token TELEGRAM_BOT_TOKEN --persist`
+- `clisbot bots add --channel slack --bot default --app-token SLACK_APP_TOKEN --bot-token SLACK_BOT_TOKEN --persist`
+- `clisbot routes add --channel telegram group:<chatId> --bot default`
+- `clisbot routes add --channel telegram topic:<chatId>:<topicId> --bot default`
+- `clisbot routes add --channel slack channel:<channelId> --bot default`
+- `clisbot routes set-agent --channel telegram group:<chatId> --bot default --agent <id>`
+- `clisbot routes set-agent --channel slack channel:<channelId> --bot default --agent <id>`
 - `clisbot --help`
 
 If you are running from the repo instead of the global package:
@@ -306,14 +337,14 @@ Command prefix defaults:
 
 - slash-style shortcuts: `["::", "\\"]`
 - bash shortcuts: `["!"]`
-- both are configurable with `channels.slack.commandPrefixes` and `channels.telegram.commandPrefixes`
+- both are configurable with `bots.defaults.commandPrefixes`, `bots.slack.defaults.commandPrefixes`, or `bots.telegram.defaults.commandPrefixes`
 
 Sensitive actions now follow auth and route policy:
 
 - `/transcript` depends on the route `verbose` policy
 - `/bash` depends on resolved agent auth through `shellExecute`
 - use `clisbot auth --help` to inspect scopes and mutate role users or permissions
-- use `clisbot channels --help` for route-level setup and channel policy guidance
+- use `clisbot routes --help` for route-level setup and route policy guidance
 
 Follow-up behavior matters in team threads:
 
@@ -386,6 +417,7 @@ This repo also serves as a small example of an AI-native engineering workflow:
 - lessons-learned docs to capture repeated feedback and pitfalls
 - architecture docs used as a stable implementation contract
 - end-to-end validation expectations to close the feedback loop for AI agents
+- workflow docs for shortest-review-first artifacts, repeated review loops, and task-readiness shaping in [docs/workflow/README.md](docs/workflow/README.md)
 
 ## Contributing