diff --git a/changelog.md b/changelog.md
index ece9046..bcc5ebb 100644
--- a/changelog.md
+++ b/changelog.md
@@ -1,5 +1,24 @@
 # changelog
 
+## v0.10.0 (2026-01-08)
+
+### changes
+
+- add transport registry with `--transport` overrides and a `takopi transports` command [#69](https://github.com/banteg/takopi/pull/69)
+- migrate config loading to pydantic-settings and move telegram credentials under `[transports.telegram]` [#65](https://github.com/banteg/takopi/pull/65)
+- include project aliases in the Telegram slash-command menu with validation and limits [#67](https://github.com/banteg/takopi/pull/67)
+
+### fixes
+
+- validate worktree roots instead of treating nested paths as worktrees [#63](https://github.com/banteg/takopi/pull/63)
+- harden onboarding with clearer config errors, safe backups, and refreshed command menu wording [#70](https://github.com/banteg/takopi/pull/70)
+
+### docs
+
+- add architecture and lifecycle diagrams
+- call out the default worktrees directory [#64](https://github.com/banteg/takopi/pull/64)
+- document the transport registry and onboarding changes [#69](https://github.com/banteg/takopi/pull/69)
+
 ## v0.9.0 (2026-01-07)
 
 ### projects and worktrees
diff --git a/docs/specification.md b/docs/specification.md
index b842c4c..9b22fb9 100644
--- a/docs/specification.md
+++ b/docs/specification.md
@@ -1,10 +1,10 @@
-# Takopi Specification v0.9.0 [2026-01-07]
+# Takopi Specification v0.10.0 [2026-01-08]
 
 This document is **normative**. The words **MUST**, **SHOULD**, and **MAY** express requirements.
 
 ## 1. Scope
 
-Takopi v0.9.0 specifies:
+Takopi v0.10.0 specifies:
 
 - A **Telegram** bot bridge that runs an agent **Runner** and posts:
   - a throttled, edited **progress message**
@@ -15,7 +15,7 @@ Takopi v0.9.0 specifies:
 - **Automatic runner selection** among multiple engines based on ResumeLine (with a configurable default for new threads)
 - A Takopi-owned **normalized event model** produced by runners and consumed by renderers/bridge
 
-Out of scope for v0.9.0:
+Out of scope for v0.10.0:
 
 - Non-Telegram clients (Slack/Discord/etc.)
 - Token-by-token streaming of the assistant’s final answer
@@ -435,6 +435,10 @@ The lock file SHOULD be removed on clean shutdown. Stale locks from crashed proc
 
 ## 11. Changelog
 
+### v0.10.0 (2026-01-08)
+
+- Require Telegram command menus to include valid project aliases and warn/truncate when exceeding 100 commands.
+
 ### v0.9.0 (2026-01-07)
 
 - No normative changes; align spec version with the v0.9.0 release.
diff --git a/pyproject.toml b/pyproject.toml
index 40b1049..3c2318e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,7 +1,7 @@
 [project]
 name = "takopi"
 authors = [{name = "banteg"}]
-version = "0.9.0"
+version = "0.10.0"
 description = "Telegram bridge for Codex, Claude Code, and other agent CLIs."
 readme = "readme.md"
 license = { file = "LICENSE" }
diff --git a/src/takopi/__init__.py b/src/takopi/__init__.py
index 3e2f46a..61fb31c 100644
--- a/src/takopi/__init__.py
+++ b/src/takopi/__init__.py
@@ -1 +1 @@
-__version__ = "0.9.0"
+__version__ = "0.10.0"
diff --git a/uv.lock b/uv.lock
index 7c20299..d1e84fc 100644
--- a/uv.lock
+++ b/uv.lock
@@ -497,7 +497,7 @@ wheels = [
 
 [[package]]
 name = "takopi"
-version = "0.9.0"
+version = "0.10.0"
 source = { editable = "." }
 dependencies = [
     { name = "anyio" },