diff --git a/.gitignore b/.gitignore
index 3349d7d..899ad2c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -6,3 +6,4 @@ __pycache__/
 .ruff_cache/
 .coverage
 .worktrees/
+research/
diff --git a/changelog.md b/changelog.md
index 69f8209..bfab16e 100644
--- a/changelog.md
+++ b/changelog.md
@@ -1,5 +1,13 @@
 # changelog
 
+## v0.6.0 (2026-01-03)
+
+### changes
+
+- interactive onboarding: run `takopi` to set up bot token, chat id, and default engine via guided prompts
+- lockfile to prevent multiple takopi instances from racing the same bot token
+- re-run onboarding anytime with `takopi --onboard`
+
 ## v0.5.3 (2026-01-02)
 
 ### changes
diff --git a/pyproject.toml b/pyproject.toml
index 98b4e8e..64ea7f8 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,7 +1,7 @@
 [project]
 name = "takopi"
 authors = [{name = "banteg"}]
-version = "0.5.3"
+version = "0.6.0"
 description = "Telegram bridge for Codex, Claude Code, and other agent CLIs."
 readme = "readme.md"
 license = { file = "LICENSE" }
diff --git a/readme.md b/readme.md
index 9bd499e..23dbb6c 100644
--- a/readme.md
+++ b/readme.md
@@ -34,7 +34,7 @@ parallel runs across threads, per thread queue support.
 
 ## setup
 
-run `takopi` in a TTY and follow the interactive prompts. it will:
+run `takopi` and follow the interactive prompts. it will:
 
 - help you create a bot token (via @BotFather)
 - capture your `chat_id` from the most recent message you send to the bot
diff --git a/src/takopi/__init__.py b/src/takopi/__init__.py
index 43a1e95..906d362 100644
--- a/src/takopi/__init__.py
+++ b/src/takopi/__init__.py
@@ -1 +1 @@
-__version__ = "0.5.3"
+__version__ = "0.6.0"
diff --git a/uv.lock b/uv.lock
index 5ef27be..a7769e3 100644
--- a/uv.lock
+++ b/uv.lock
@@ -378,7 +378,7 @@ wheels = [
 
 [[package]]
 name = "takopi"
-version = "0.5.3"
+version = "0.6.0"
 source = { editable = "." }
 dependencies = [
     { name = "anyio" },