Releases: OpenCSGs/csgclaw
v0.2.8
What's Changed
This release expands runtime support, streamlines setup and upgrades, and improves the web and messaging experience across the platform.
Highlights:
- Added ACP-backed Codex worker runtime support, including runtime selection, profile bridging, bot mention filtering, and runtime visibility in the CLI and web UI.
- Introduced in-place upgrade flows in both the CLI and web UI, with version checks, download/install handling, and restart coordination.
- Simplified first-run setup by moving onboarding behind
serve, removing the public onboard command, and making config values like manager image and Debian registries override-only. - Improved web and IM behavior with shared SSE connections across tabs, auto-opening the IM URL on healthy server startup, pasted
@handlemention parsing, and fixes for post-restart message delivery. - Reduced runtime and packaging complexity by removing the BoxLite SDK sandbox provider, keeping the CLI-based sandbox model, and adding Linux arm64 release support.
Full Changelog
- chore: simplify install script onboarding hint (3bc4475)
- refactor(config): make manager image an explicit override (c08a4d5)
- feat: introduce model auth and adjust ui style (#24) (75e9327)
- refactor: extract onboard state management and auto-bootstrap on serve (b8f6d96)
- refactor(config): make Debian registries override-only (131d14f)
- chore: archive some docs (ca9d6e9)
- fix: show debian_registries_override in config and serve output (fd57083)
- refactor(cli): remove onboard command (1fce104)
- feat(serve): auto-open IM URL after server becomes healthy (7dc687e)
- feat(web): share /api/v1/events SSE connection across tabs (89506dc)
- feat: add version endpoint and show version in sidebar (f948204)
- refactor: remove BoxLite SDK sandbox provider (516e4dc)
- docs: remove stale BoxLite SDK references and simplify README (d2c115d)
- build: add linux arm64 release and upgrade boxlite-cli to v0.9.0 (eceae4a)
- refactor: rename picoclaw bridge/api internals to bot terms (cb7b541)
- refactor(skills): remove local settings fallback from the dispatch skill (caf41aa)
- refactor(agent): introduce runtime abstraction for PicoClaw sandbox (9069ab1)
- refactor(agent): stop recreating running agents for bot recovery (b2fc40b)
- feat(runtime): add ACP-backed codex worker runtime (e00e554)
- feat: show agent runtime kind in CLI and web UI (6867a1f)
- refactor: create bots via bot API and simplify IM provisioning (df3e7ce)
- feat(cli): add csgclaw upgrade command (b3b10cc)
- feat(web): add UI-triggered upgrade flow (fc31591)
- refactor(agent): centralize codex bridge lifecycle and recovery (9f61032)
- feat(codex): bridge runtime profile config and stale model loads (9a4007e)
- feat(codex): filter group events by bot mention (f22b501)
- feat(web): parse pasted
@handlementions into composer tokens (5e05c59)
v0.2.7
What's Changed
This release improves runtime reliability for bundled BoxLite resolution.
Highlights:
- Fixed bundled
boxlitediscovery whencsgclawis launched through a symlinked executable path. - Added structured fallback logs for unknown agent statuses to improve troubleshooting.
- Updated make run to execute the built binary, making local run behavior closer to packaged usage.
Full Changelog
v0.2.6
What's Changed
This release expands agent profile and routing flexibility while refining the web UI for everyday agent management.
Highlights:
- Added dynamic per-agent profile and routing support, including provider/model selection, reasoning and request options, persistence, CLIProxy-backed model discovery, and related onboarding and config updates.
- Improved the web UI for navigation and profile browsing with fixed left-sidebar tabs and a new avatar popover for profile previews.
- Polished agent and bot management flows with preview-side bot deletion, more resilient cleanup, and more consistent action button styling.
- Fixed dispatch-skill compatibility for log-based consumers and bumped the default PicoClaw manager image.
Full Changelog
- feat: support dynamic profile/routing for agent (#18) (6d50d2a)
- fix(web): compact sidebar header controls into a single row (1b59f1e)
- fix(agent): add bot delete action in preview (4b4c942)
- fix(skills): fix the dispatch skill and bump default image (3af4f93)
- feat(web): add two fixed tabs to the left sidebar (#20) (9e314a4)
- fix(web): unify bot/agent action button styles (ed3898b)
- feat(web): move profile preview to avatar popover (901f954)
v0.2.5
What's Changed
This release improves agent creation workflows, simplifies BoxLite configuration, and adds configurable logging for serve and onboarding flows.
Highlights:
- Added --log-level support for serve and onboarding, including debug logging for executed BoxLite CLI commands.
- Added agent replacement support through csgclaw agent create --replace, with --force for non-interactive replacement.
- Added custom agent image support, including list output visibility and fallback behavior.
- Moved replacement semantics into the create API so masked fields are merged consistently before recreation.
- Removed legacy BoxLite and manager recreation configuration paths in favor of bundled-or-PATH BoxLite resolution and default manager image handling.
Full Changelog
- refactor(config): remove boxlite_cli_path (7ac938d)
- feat(serve): add configurable log levels (108a609)
- feat(onboard): add configurable log level for onboarding (10fb6ca)
- fix(config): enforce default manager image when starting serve (#17) (a5c0549)
- feat(cli): support replacing existing agents via agent create (7564051)
- feat(cli): support custom agent image with fallback (96ae5ae)
- feat(agent): move replace handling into create API (59f3ad7)
- test(cli): update room table assertions (b631806)
- refactor(onboard): remove force recreate manager option (6de58ed)
v0.2.4
What's Changed
This release focuses on safer agent lifecycle management, more reliable IM state handling, and smoother default local setup.
Highlights:
- Improved agent management in the CLI by adding bulk deletion with confirmation and fixing deletion of the reserved manager agent.
- Fixed IM read behavior so persisted state is reloaded before serving APIs, reducing stale or missing data after restarts.
- Updated the default build and runtime path to favor the boxlite-cli shape, with accompanying install, onboarding, and documentation refreshes.
- Passed SKILLS_POLL_INTERVAL into CSGHub sandboxes to improve sandbox runtime configuration.
Full Changelog
- fix(im): reload persisted IM state before serving read APIs (9fcf072)
- fix(agent): allow deleting reserved manager agent (62541ed)
- feat(cli): support deleting all agents with confirmation (54c403b)
- feat(sandbox): pass SKILLS_POLL_INTERVAL to CSGHub sandboxes (#16) (42002d0)
- fix(cli): remove agent status command (22d5983)
- docs: refresh install and onboarding instructions (c16e289)
- fix(build): make boxlite-cli the default build shape (8390965)
- chore: switch install scripts to use csgclaw.opencsg.com release URLs (d09dd9a)
v0.2.3
What's Changed
This release improves the web UI and room messaging behavior while also making packaged releases more reliable and self-contained.
Highlights:
- Improved web UI behavior with smoother sidebar transitions, better member-list dismissal, and smarter message auto-scrolling that avoids interrupting users reading older
messages. - Fixed room message fan-out so member bots receive room messages even without explicit mentions.
- Updated release packaging to bundle the BoxLite CLI with csgclaw, alongside a CI fix that avoids package-script failures from empty build args.
Full Changelog
- fix(ci): avoid empty build args failure in package script (b148e9f)
- fix(web): only auto-scroll message list when user is at bottom (86e9a99)
- feat(web): animate sidebar collapse and expand transitions (d1fc9eb)
- feat(web): close room member list when clicking outside (7fa75d1)
- fix(im): push room messages to all member bots without mention (c06f82e)
- feat: ship bundled boxlite CLI with csgclaw releases (358cf9a)
v0.2.2
What's Changed
This release improves day-to-day multi-agent operations with better observability, stronger agent and IM lifecycle handling, and a much smoother messaging experience.
Highlights:
- Added HTTP access logging and refreshed default runtime settings, including OpenCSG PicoClaw image defaults, Debian registries, and release/build adjustments.
- Expanded user and bot lifecycle management with csgclaw user creation, bot-linked user cleanup, and IM deletion events synced through the backend and frontend.
- Added agent start/stop controls and made runtime status reporting more accurate by hydrating live sandbox state and tightening bot availability checks.
- Upgraded chat and room workflows with direct rooms, structured mentions, preserved mention metadata, per-room composer drafts, and better mention routing.
- Improved sandbox and dispatch behavior with CSGHub sandbox updates, manager flow refactoring, and worker bootstrap cleanup.
Full Changelog
- feat(server): add slog access logging for all HTTP handlers (0e01b0a)
- chore: temporarily disable linux arm64 release build (55388ab)
- feat(config): default OpenCSG picoclaw image and Debian registries (#15) (f94b9a3)
- fix(im): use mentioned user handle (76d05e8)
- feat(sandbox): improve CSGHub sandbox (#12) (f56942f)
- fix(config): normalize config.toml section spacing (dd5f969)
- feat: add csgclaw user creation and extract IM provisioner (c64ca13)
- feat(bot): delete csgclaw users when removing bots (8cf44a0)
- feat(im): publish user deletion events (8086253)
- refactor(room): rename participants to members across room models (390335f)
- feat(agent): add start and stop commands (d98e83a)
- fix(agent): hydrate live status from sandbox (fc39124)
- fix(bot): mark listed bots available only when agent is running (c28e5e8)
- feat(im): add direct rooms support (665a3c6)
- feat: add structured mentions (3cb13e4)
- fix(im): preserve mention metadata and direct/group detection (65e32ae)
- fix(web): preserve per-room composer drafts and caret behavior (efe4fd8)
- feat(skills): add basics skill and refactor manager dispatch flow (150b938)
- fix(im): simplify worker bootstrap message (68ab412)
- chore: update github-release-notes skill (22a125c)
v0.2.1
What's Changed
This release expands sandbox and model provider flexibility, improves agent runtime setup, and tightens CLI, config, API, and web behavior for local multi-agent deployments.
Highlights:
- Added embedded PicoClaw runtime workspaces so agents can start with bundled manager and worker files mounted directly into their boxes.
- Expanded sandbox support with configurable providers, a BoxLite CLI-backed provider, a CSGHub sandbox provider, and build-tag-aware provider selection.
- Added CSGHub-lite model integration, including provider-aware onboarding, model discovery, local defaults, and startup preflight checks.
- Improved operator-facing configuration with environment variable expansion, explicit server.no_auth, Debian registry settings for BoxLite, and better callback URL handling via
advertise_base_url. - Extended channel-aware management flows in the CLI and API, including room delete and user delete support, plus fixes for default channel handling and web asset fetch paths.
Full Changelog
- chore: add Linux arm64 release artifacts (94ec565)
- feat(agent): embed and mount runtime workspaces for PicoClaw agents (1d99889)
- feat(agent): normalize PicoClaw bridge model IDs (#3) (7628f81)
- feat(model): integrate with CSGHub-lite (#5) (381dad3)
- feat(agent): introduce configurable sandbox provider (fdf409d)
- feat(sandbox): add BoxLite CLI sandbox provider (7419bfc)
- fix(agent): prefer advertise_base_url for box callbacks (ea32ced)
- docs: refresh architecture diagram (bd37b41)
- chore: update logo asset (a363d0c)
- refactor: make sandbox providers build-tag aware (3027b2a)
- refactor(sandbox): rename BoxLite SDK adapter packages for clarity (59cc9a4)
- feat(sandbox): add CSGHub sandbox provider (8032cd4)
- docs: add Feishu channel configuration guides (ab2e9f6)
- fix(cli): default member list channel to csgclaw (e88ce2a)
- feat(cli): support channel-aware room delete (3aa1a82)
- feat(cli): rename user kick to delete and add channel flag (1d4d15f)
- docs: add dedicated CLI docs (19ca2ea)
- feat(config): support environment variable expansion in config (0a85444)
- fix(api): skip auth when server access token is empty (3f532d9)
- docs: update architecture and README (1f80aa6)
- feat(config): add explicit server no_auth setting (6216115)
- feat(config): add debian_registries setting for BoxLite sandbox (#13) (99e037b)
- fix(web): remove leading slashes from fetch URLs (#11) (128a653)
- refactor(api): remove deprecated /api/v1/workers endpoints (da394d8)
- chore: update default picoclaw image tag to 2026.4.24.0 (ca2584f)
v0.2.0
What's Changed
This release expands CSGClaw into a channel-aware multi-agent platform with deeper Feishu integration, bot lifecycle management, a split CLI, and improved automation support.
Highlights:
- Added Feishu channel support for users, rooms, room members, messages, bot mentions, and event streaming.
- Introduced bot management across API and CLI, including list, create, delete, manager bootstrap, role filtering, descriptions, and channel-aware agent reuse.
- Split and slimmed CLI commands into reusable packages, added csgclaw-cli, cross-platform CLI builds, env-based auth, and JSON output behavior for automation.
- Improved IM persistence by moving room messages into per-room JSONL session files.
- Added profile-based LLM routing and channel-aware manager dispatch tracking.
Full Changelog
- chore: print config on startup and add AGENTS.md (#1) (bcca39d)
- refactor(im): move message persistence to session files (8f7993e)
- chore: archive some docs (e544041)
- feat(channel): add Feishu user and room support (a179bca)
- feat(channel): create rooms through Feishu chat API (538bbfe)
- feat(channel): add Feishu room member creation support (bb7dfff)
- feat(channel): support listing room members via Feishu API (4eb8b29)
- feat(bot): add bot list service, API, and CLI (9ea938a)
- feat(bot): support creating worker bots via API and CLI (029d13b)
- feat(bot): support manager bot bootstrap during onboard (9d639e4)
- refactor(api): route worker creation through bot service (85b1c56)
- feat(channel): implement ListRooms via Feishu chat list API (5b2d6fa)
- refactor(cli): split commands into packages and add csgcli (1505308)
- feat: add channel-aware message sending with Feishu support (ae447c2)
- docs: update architecture docs (fd34967)
- refactor(cli): rename csgcli to csgclaw-cli (cf1d0fd)
- feat(channel): add message bus event stream for Feishu bot mentions (e12bb44)
- feat(agent): inject Feishu env vars into agent box (ded028c)
- feat: add profile-based LLM routing and improve skill (#2) (c88471d)
- feat(bot): support reusing same agent across channels (44db80b)
- feat(bot): add bot delete command and API support (134ef60)
- chore: update default picoclaw config and bump the image tag (27e8957)
- feat(cli): add room member listing for csgclaw channel (66568c3)
- feat(channel): include configured bots when listing Feishu room members (e1472e2)
- feat: add message list command and Feishu message retrieval (58fca17)
- refactor(cli): slim down csgclaw-cli (fe9b82c)
- feat: support env-based CLI auth and cross-platform csgclaw-cli builds (e235e4e)
- feat(bot): support --role filter in bot list command (25a8d3d)
- fix(bot): use configured app open IDs as Feishu user IDs (c75ee17)
- feat(bot): list configured unavailable Feishu bots (74d5e94)
- feat(bot): enrich metadata for configured Feishu bots (1e3c0a0)
- feat(im): add @ prefix to mention messages (7a364d6)
- feat(cli): support csgclaw room member creation (8a216f4)
- feat(bot): expose bot descriptions in API and CLI output (a5ad3fe)
- feat(cli): support --output json for all action commands (cf12560)
- feat(cli): default to json output for non-terminal stdout (72db4ad)
- feat(skills): add channel-aware manager dispatch tracking (e7a4062)
v0.1.5
What's Changed
This release tightens the CLI and configuration model while polishing the web chat composer and message entry experience.
Highlights:
- Refined the web chat UI with a redesigned inline send button, improved composer styling, and highlighted @mentions.
- Simplified server configuration by consolidating access token handling, renaming the llm config to model, and replacing api_base_url with optional advertise_base_url.
- Updated the CLI and docs to standardize on serve and remove the start alias.
- Added the Apache 2.0 LICENSE file.
Full Changelog
- feat(web): refine new room button styling and highlight @mentions (bb4114a)
- feat(web): redesign composer send button (9f38e06)
- docs: add LICENSE for Apache 2.0 (855de89)
- refactor(config): replace api_base_url with optional advertise_base_url (b569dc8)
- refactor(config): move shared access token to server config (8456a5e)
- refactor(config): rename llm config to model (36ecdb8)
- refactor(config): centralize default API address handling (1ce98bb)
- refactor(cli): remove start alias and update CLI help text (f8021ab)