diff --git a/package.json b/package.json
index a431f9ed..a6a804d1 100644
--- a/package.json
+++ b/package.json
@@ -20,6 +20,9 @@
 		"prepublishOnly": "npm run clean && npm run build && npm run check",
 		"publish": "npm run prepublishOnly && npm publish -ws --access public",
 		"publish:dry": "npm run prepublishOnly && npm publish -ws --access public --dry-run",
+		"release:patch": "node scripts/release.mjs patch",
+		"release:minor": "node scripts/release.mjs minor",
+		"release:major": "node scripts/release.mjs major",
 		"prepare": "husky"
 	},
 	"devDependencies": {
diff --git a/scripts/release.mjs b/scripts/release.mjs
new file mode 100755
index 00000000..12b33d04
--- /dev/null
+++ b/scripts/release.mjs
@@ -0,0 +1,145 @@
+#!/usr/bin/env node
+/**
+ * Release script for pi-mono
+ *
+ * Usage: node scripts/release.mjs <major|minor|patch>
+ *
+ * Steps:
+ * 1. Check for uncommitted changes
+ * 2. Bump version via npm run version:xxx
+ * 3. Update CHANGELOG.md files: [Unreleased] -> [version] - date
+ * 4. Commit and tag
+ * 5. Publish to npm
+ * 6. Add new [Unreleased] section to changelogs
+ * 7. Commit
+ */
+
+import { execSync } from "child_process";
+import { readFileSync, writeFileSync, readdirSync, existsSync } from "fs";
+import { join } from "path";
+
+const BUMP_TYPE = process.argv[2];
+
+if (!["major", "minor", "patch"].includes(BUMP_TYPE)) {
+	console.error("Usage: node scripts/release.mjs <major|minor|patch>");
+	process.exit(1);
+}
+
+function run(cmd, options = {}) {
+	console.log(`$ ${cmd}`);
+	try {
+		return execSync(cmd, { encoding: "utf-8", stdio: options.silent ? "pipe" : "inherit", ...options });
+	} catch (e) {
+		if (!options.ignoreError) {
+			console.error(`Command failed: ${cmd}`);
+			process.exit(1);
+		}
+		return null;
+	}
+}
+
+function getVersion() {
+	const pkg = JSON.parse(readFileSync("packages/ai/package.json", "utf-8"));
+	return pkg.version;
+}
+
+function getChangelogs() {
+	const packagesDir = "packages";
+	const packages = readdirSync(packagesDir);
+	return packages
+		.map((pkg) => join(packagesDir, pkg, "CHANGELOG.md"))
+		.filter((path) => existsSync(path));
+}
+
+function updateChangelogsForRelease(version) {
+	const date = new Date().toISOString().split("T")[0];
+	const changelogs = getChangelogs();
+
+	for (const changelog of changelogs) {
+		const content = readFileSync(changelog, "utf-8");
+
+		if (!content.includes("## [Unreleased]")) {
+			console.log(`  Skipping ${changelog}: no [Unreleased] section`);
+			continue;
+		}
+
+		const updated = content.replace(
+			"## [Unreleased]",
+			`## [${version}] - ${date}`
+		);
+		writeFileSync(changelog, updated);
+		console.log(`  Updated ${changelog}`);
+	}
+}
+
+function addUnreleasedSection() {
+	const changelogs = getChangelogs();
+	const unreleasedSection = "## [Unreleased]\n\n";
+
+	for (const changelog of changelogs) {
+		const content = readFileSync(changelog, "utf-8");
+
+		// Insert after "# Changelog\n\n"
+		const updated = content.replace(
+			/^(# Changelog\n\n)/,
+			`$1${unreleasedSection}`
+		);
+		writeFileSync(changelog, updated);
+		console.log(`  Added [Unreleased] to ${changelog}`);
+	}
+}
+
+// Main flow
+console.log("\n=== Release Script ===\n");
+
+// 1. Check for uncommitted changes
+console.log("Checking for uncommitted changes...");
+const status = run("git status --porcelain", { silent: true });
+if (status && status.trim()) {
+	console.error("Error: Uncommitted changes detected. Commit or stash first.");
+	console.error(status);
+	process.exit(1);
+}
+console.log("  Working directory clean\n");
+
+// 2. Bump version
+console.log(`Bumping version (${BUMP_TYPE})...`);
+run(`npm run version:${BUMP_TYPE}`);
+const version = getVersion();
+console.log(`  New version: ${version}\n`);
+
+// 3. Update changelogs
+console.log("Updating CHANGELOG.md files...");
+updateChangelogsForRelease(version);
+console.log();
+
+// 4. Commit and tag
+console.log("Committing and tagging...");
+run("git add .");
+run(`git commit -m "Release v${version}"`);
+run(`git tag v${version}`);
+console.log();
+
+// 5. Publish
+console.log("Publishing to npm...");
+run("npm run publish");
+console.log();
+
+// 6. Add new [Unreleased] sections
+console.log("Adding [Unreleased] sections for next cycle...");
+addUnreleasedSection();
+console.log();
+
+// 7. Commit
+console.log("Committing changelog updates...");
+run("git add .");
+run(`git commit -m "Add [Unreleased] section for next cycle"`);
+console.log();
+
+// 8. Push
+console.log("Pushing to remote...");
+run("git push origin main");
+run(`git push origin v${version}`);
+console.log();
+
+console.log(`=== Released v${version} ===`);