diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 00000000..6c1039d9
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,16 @@
+# CLAUDE.md
+
+## Setup
+mise install
+mise run install
+
+## Run
+npm run dev
+
+## Smoke
+mise run smoke
+
+## Rules
+- Touch one service area at a time (client or server).
+- Keep docker/selfhost files valid.
+- Run smoke before commit.
diff --git a/README.md b/README.md
index 39602977..f29fd4a1 100644
--- a/README.md
+++ b/README.md
@@ -42,7 +42,16 @@
 >
 > Our goal is to give everyone personal super-intelligence.
 >
-> [Read our manifesto.](https://docs.google.com/document/d/1vbCGAbh9f8vXfPup_Z7cW__gnOLdRhEtHKyoIxJD8is/edit?tab=t.0#heading=h.2kit9yqvlc77)
+> It acts as your central command center, bridging the gap between your goals and the actions required to achieve them. It is designed to be a truly proactive partner that understands you, manages your digital life, and gets things done—without you having to type long, complex prompts.
+>
+> It can:
+> - **💬 Chat with you** about any topic via text or voice.
+> - **🧠 Learn your preferences, habits, and goals** to better serve you over time.
+> - **⚙️ Execute complex, multi-step tasks** and recurring workflows.
+> - **🗓️ Proactively manage your day**, reading your emails and calendar to suggest schedules and remind you of important events.
+> - **🔗 Integrate seamlessly** with the apps you use every day.
+>
+> For more information [read our manifesto.](https://docs.google.com/document/d/1vbCGAbh9f8vXfPup_Z7cW__gnOLdRhEtHKyoIxJD8is/edit?tab=t.0#heading=h.2kit9yqvlc77)
 
 ---
 
@@ -83,8 +92,7 @@
 To access Sentient, head over to [our website.](https://sentient.existence.technology/)
 
 ### 🔒 Self-Hostable
-
-The entire platform can be self-hosted and configured to run fully locally. [Check the relevant docs for more info.](https://sentient-2.gitbook.io/docs/getting-started/running-sentient-from-source-self-host)
+The entire platform is open-source and can be self-hosted and configured to run fully locally, ensuring your data stays private. [Check the relevant docs for more info.](https://sentient-2.gitbook.io/docs/getting-started/running-sentient-from-source-self-host)
 
 ---
 
@@ -126,7 +134,7 @@ Distributed under the GNU AGPL License. See [LICENSE.txt](https://github.com/exi
        <a href="https://github.com/itsskofficial">
          <img src="https://avatars.githubusercontent.com/u/65887545?v=4?s=100" width="100px;" alt=""/>
          <br />
-         <sub><b>itsskofficial</b></sub>
+         <sub><b>itsskofficial (Sarthak)</b></sub>
        </a>
      </td>  
      <td align="center">
diff --git a/mise.toml b/mise.toml
new file mode 100644
index 00000000..a5ffe824
--- /dev/null
+++ b/mise.toml
@@ -0,0 +1,9 @@
+[tools]
+node = "24.13.1"
+python = "3.14"
+
+[tasks.install]
+run = "npm install --no-package-lock && (cd src/client && npm install)"
+
+[tasks.smoke]
+run = "bash scripts/smoke.sh"
diff --git a/package.json b/package.json
index c65d685e..d91fec93 100644
--- a/package.json
+++ b/package.json
@@ -11,7 +11,8 @@
 		"start": "next start",
 		"lint": "next lint",
 		"format": "prettier --write .",
-		"format:check": "prettier --check ."
+		"format:check": "prettier --check .",
+		"smoke": "bash scripts/smoke.sh"
 	},
 	"dependencies": {
 		"next": "^14.2.0",
@@ -28,5 +29,6 @@
 		"postcss": "^8.0.0",
 		"prettier": "^3.2.5",
 		"tailwindcss": "^3.0.0"
-	}
-}
\ No newline at end of file
+	},
+	"packageManager": "npm@11.10.0"
+}
diff --git a/scripts/smoke.sh b/scripts/smoke.sh
new file mode 100755
index 00000000..0904262e
--- /dev/null
+++ b/scripts/smoke.sh
@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+cd "$(dirname "$0")/.."
+npm install --no-package-lock
+if [ -f src/client/package.json ]; then
+  (cd src/client && npm install && npm run build --if-present)
+fi
+echo "sentient smoke passed"
diff --git a/src/client/package.json b/src/client/package.json
index 683b6926..818dc7ef 100644
--- a/src/client/package.json
+++ b/src/client/package.json
@@ -87,5 +87,6 @@
 		"prettier": "^3.2.5",
 		"tailwindcss": "^4.0.7",
 		"typescript": "^5.5.0"
-	}
+	},
+	"packageManager": "npm@11.10.0"
 }