diff --git a/CHANGELOG.md b/CHANGELOG.md
index b3b23b87..5d0811e2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,19 @@
 
 ## [Unreleased]
 
+## [3.1.0] - 2026-09-02
+
+`devbase up` でコンテナを作り直しても VS Code Server が残るようになり、
+アカウントグループを分けたときに他社の GCP 鍵がコンテナへ渡らなくなりました。
+`devbase build <image>` の単体ビルドも動くようになっています。
+
+`FROM devbase-*` を使うプロジェクトは、VS Code Server の永続化と Antigravity CLI の
+追加を反映するために**ベースイメージの再ビルド**が要ります。
+
+```bash
+devbase build base --no-cache
+```
+
 ### Added
 - **VS Code Server をコンテナ再作成をまたいで保つ**ようにしました (PLAN36)。
   `~/.vscode-server` はこれまでコンテナ層 (揮発) にあったため、`devbase up` で
@@ -428,6 +441,7 @@ OSS 化に伴う初回リリース。devbase は本バージョンより `devbas
 ### Removed
 - 「公式レジストリ」固定の概念を廃止。各レジストリは対等な扱いとなる。
 
-[Unreleased]: https://github.com/devbasex/devbase/compare/v3.0.0...HEAD
+[Unreleased]: https://github.com/devbasex/devbase/compare/v3.1.0...HEAD
+[3.1.0]: https://github.com/devbasex/devbase/compare/v3.0.0...v3.1.0
 [3.0.0]: https://github.com/devbasex/devbase/compare/v2.2.0...v3.0.0
 [2.2.0]: https://github.com/devbasex/devbase/releases/tag/v2.2.0
diff --git a/docs/developer/architecture.md b/docs/developer/architecture.md
index 77a3bba9..fd62b2a3 100644
--- a/docs/developer/architecture.md
+++ b/docs/developer/architecture.md
@@ -1,6 +1,6 @@
 # devbase アーキテクチャ概要
 
-devbase v3.0.0 のアーキテクチャ設計と内部構造について説明する。
+devbase v3.1.0 のアーキテクチャ設計と内部構造について説明する。
 
 ## 全体構成
 
diff --git a/lib/devbase/__init__.py b/lib/devbase/__init__.py
index 9eaa5dd6..429fc045 100644
--- a/lib/devbase/__init__.py
+++ b/lib/devbase/__init__.py
@@ -1,4 +1,4 @@
 """devbase - Docker-based Development Environment Manager"""
 
-__version__ = "3.0.0"
+__version__ = "3.1.0"
 __author__ = "devbase team"
diff --git a/lib/devbase/cli.py b/lib/devbase/cli.py
index ee7102cc..30708339 100644
--- a/lib/devbase/cli.py
+++ b/lib/devbase/cli.py
@@ -14,7 +14,7 @@
 try:
     from . import __version__
 except ImportError:
-    __version__ = "3.0.0"
+    __version__ = "3.1.0"
 
 logger = get_logger("devbase.cli")
 
diff --git a/pyproject.toml b/pyproject.toml
index 8af0bd17..7e6df40c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "devbase"
-version = "3.0.0"
+version = "3.1.0"
 description = "Docker-based Development Environment Manager"
 requires-python = ">=3.10"
 dependencies = [
diff --git a/uv.lock b/uv.lock
index b33e944a..9aafd3de 100644
--- a/uv.lock
+++ b/uv.lock
@@ -41,7 +41,7 @@ wheels = [
 
 [[package]]
 name = "devbase"
-version = "3.0.0"
+version = "3.1.0"
 source = { virtual = "." }
 dependencies = [
     { name = "boto3" },
@@ -75,7 +75,7 @@ name = "exceptiongroup"
 version = "1.3.1"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
-    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+    { name = "typing-extensions" },
 ]
 sdist = { url = "https://files.pythonhosted.org/packages/50/79/66800aadf48771f6b62f7eb014e352e5d06856655206165d775e675a02c9/exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219", size = 30371, upload-time = "2025-11-21T23:01:54.787Z" }
 wheels = [