diff --git a/CHANGELOG.md b/CHANGELOG.md
index 488570a..c8fc644 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.3.1] - 2026-05-28
+
+### Changed
+- **README rewritten** — honest, building-in-public voice; drops the legacy "thinks/heals/remembers/evolves" + "nervous system / immune system" marketing copy. Fixes two factual errors (subprocess timeout is 5 min not 10; reconnect uses backoff). Ships to npm with this release.
+- **`package.json` description** refreshed to match — plain description of what the connector does, no version-coupled marketing.
+
+No runtime behavior change.
+
 ## [3.3.0] - 2026-05-22
 
 ### Fixed
diff --git a/package.json b/package.json
index 3d05778..4da058d 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@askalf/agent",
-  "version": "3.3.0",
-  "description": "Connect any device to an AI workforce that thinks, heals, remembers, and evolves. Nervous system signals, immune system alerts, auto-reconnect, capabilities scan. One command to install as a persistent service.",
+  "version": "3.3.1",
+  "description": "Connect any device to your askalf fleet. A WebSocket connector that registers a machine and runs the shell or Claude Code tasks the fleet dispatches, streaming results back. Installs as a system service; auto-reconnect, heartbeat, capability scan.",
   "type": "module",
   "main": "dist/index.js",
   "types": "./dist/index.d.ts",