From 281eb0d451b821faaa6af83b44bde26c4e013062 Mon Sep 17 00:00:00 2001
From: Braden Wong <13159333+braden-w@users.noreply.github.com>
Date: Mon, 11 Aug 2025 00:25:30 -0700
Subject: [PATCH] docs: improve README initialization section clarity

- Add explicit 'turso' command example in shell block
- Separate shell command from interactive session output
- Add context explaining what the command does
- Improve copy-paste experience for new users
- Follow standard CLI documentation patterns

Fixes unclear initialization flow where users didn't know
what command to run after installation.
---
 README.md | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 8dc7cdc1b..fa2751116 100644
--- a/README.md
+++ b/README.md
@@ -67,7 +67,13 @@ curl --proto '=https' --tlsv1.2 -LsSf \
   https://github.com/tursodatabase/turso/releases/latest/download/turso_cli-installer.sh | sh
 ```
 
-Then launch the shell to execute SQL statements:
+Then launch the interactive shell:
+
+```shell
+$ turso
+```
+
+This will start the Turso interactive shell where you can execute SQL statements:
 
 ```console
 Turso