birdclaw 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## 0.2.1 - 2026-04-27
+
+### Changed
+
+- Use Twitter wording in public descriptions, docs, CLI help, and release notes.
+
 ## 0.2.0 - 2026-04-27
 
 ### Added
@@ -13,7 +19,7 @@ All notable changes to this project will be documented in this file.
 
 ### Changed
 
-- Update the README tagline and package description for local X memory across archives, DMs, likes, bookmarks, and moderation.
+- Update the README tagline and package description for local Twitter memory across archives, DMs, likes, bookmarks, and moderation.
 - Refresh dependencies, including `jsdom` 29.1.0.
 - Hide reply state and reply actions in saved likes/bookmarks web lanes.
 - Shard backup DMs by year and route unknown tweet dates to `data/tweets/unknown.jsonl` so Git backups stay compact and avoid bogus 1970 files.
@@ -21,7 +27,7 @@ All notable changes to this project will be documented in this file.
 
 ### Fixed
 
-- Fix live bookmark sync to use stored X user ids, force OAuth2 for `xurl` collection reads, and tolerate large/current `bird` bookmark payloads.
+- Fix live bookmark sync to use stored Twitter user ids, force OAuth2 for `xurl` collection reads, and tolerate large/current `bird` bookmark payloads.
 - Fix fresh-machine backup sync so demo data is never exported into Git backups, and keep no-op syncs from creating metadata-only commits.
 
 ## 0.1.1 - 2026-04-27
@@ -38,7 +44,7 @@ All notable changes to this project will be documented in this file.
 
 ### Added
 
-- Add X web cookie fallback for block and unblock actions when the X API rejects OAuth2 block writes.
+- Add Twitter web cookie fallback for block and unblock actions when the Twitter API rejects OAuth2 block writes.
 - Add `profiles replies` so moderation triage can inspect a user's recent reply pattern before blocking.
 - Add `blocks import <path>` for one-shot blocklist application from a file.
 - Add paged `mentions export --mode xurl --all --max-pages <n>` so moderation loops can scan the full retrievable mentions window.

package/README.md

@@ -1,12 +1,12 @@
-# birdclaw 🪶 — Local X memory in SQLite: archives, DMs, likes, bookmarks
+# birdclaw 🪶 — Local Twitter memory in SQLite: archives, DMs, likes, bookmarks
 
-`birdclaw` is a local-first X workspace: archive import, cached live reads, focused triage, and reply flows in one local web app + CLI. Built by [@steipete](https://github.com/steipete/).
+`birdclaw` is a local-first Twitter workspace: archive import, cached live reads, focused triage, and reply flows in one local web app + CLI. Built by [@steipete](https://github.com/steipete/).
 
 Status: WIP. Real and usable. Not done. Expect schema churn, transport gaps, and rough edges while the core settles.
 
 ## What It Does
 
-- keeps your X data in local SQLite
+- keeps your Twitter data in local SQLite
 - stores media and avatar cache under `~/.birdclaw`
 - imports archives when you have them
 - still works when you do not
@@ -24,7 +24,7 @@ Status: WIP. Real and usable. Not done. Expect schema churn, transport gaps, and
 - archive import for bookmark exports when present
 - live likes and bookmarks sync through `xurl` or `bird`
 - Git-friendly text backups with yearly tweet shards and per-conversation DM shards
-- profile hydration from live X metadata
+- profile hydration from live Twitter metadata
 - local avatar cache
 - local media cache root under `~/.birdclaw`
 
@@ -61,7 +61,7 @@ Status: WIP. Real and usable. Not done. Expect schema churn, transport gaps, and
 - import batch blocklists in one call
 - add / remove local mutes
 - sync remote blocks through `xurl` when available
-- fall back to the X web cookie session when OAuth2 block writes are rejected
+- fall back to the Twitter web cookie session when OAuth2 block writes are rejected
 
 ### Safety
 
@@ -82,7 +82,7 @@ If you need polished product-grade sync parity today, this is not there yet.
 
 ## Screens
 
-- `Home`: read and reply without fighting the main X timeline
+- `Home`: read and reply without fighting the main Twitter timeline
 - `Mentions`: work the reply queue with clean filters
 - `Likes` / `Bookmarks`: revisit saved posts from archive or live sync
 - `DMs`: triage by sender context, follower count, and influence
@@ -295,7 +295,7 @@ Notes:
 - `ban` / `unban` accept `--transport auto|bird|xurl`
 - `auto` tries `bird` first, then falls back to `xurl` when bird fails
 - forced `xurl` writes still verify through `bird status` before sqlite changes
-- X still rejects pure OAuth2 block writes, so `auto` is the safe default for block/unblock
+- Twitter still rejects pure OAuth2 block writes, so `auto` is the safe default for block/unblock
 - `blocks import` accepts newline-delimited blocklists with comments and markdown bullets
 - `blocks sync` is for slow/manual remote reconciliation; not for a hot cron loop
 - `blocks record` stores a known-good remote block locally without issuing another live write
@@ -432,7 +432,7 @@ tail -n 1 ~/.birdclaw/audit/bookmarks-sync.jsonl | jq .
 ## Typical Workflow
 
 1. import your archive if you have one
-2. hydrate imported profiles from live X metadata
+2. hydrate imported profiles from live Twitter metadata
 3. use `Home` for reading
 4. use `Mentions` for reply triage
 5. when one account feels borderline, inspect `profiles replies`

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "birdclaw",
-	"version": "0.2.0",
-	"description": "Local X memory in SQLite for archives, DMs, likes, bookmarks, and moderation",
+	"version": "0.2.1",
+	"description": "Local Twitter memory in SQLite for archives, DMs, likes, bookmarks, and moderation",
 	"homepage": "https://github.com/steipete/birdclaw#readme",
 	"license": "MIT",
 	"repository": {

package/src/cli.ts

@@ -85,7 +85,7 @@ async function autoSyncAfterWrite() {
 
 program
 	.name("birdclaw")
-	.description("Local-first X workspace")
+	.description("Local-first Twitter workspace")
 	.version(packageVersion.version ?? "0.0.0")
 	.option("--json", "Emit JSON output");
 
@@ -118,7 +118,7 @@ program
 
 program
 	.command("archive find")
-	.description("Find likely X/Twitter archives on disk")
+	.description("Find likely Twitter archives on disk")
 	.action(async () => {
 		const items = await findArchives();
 		print(items, program.opts().json ?? false);
@@ -130,7 +130,7 @@ const importCommand = program
 
 importCommand
 	.command("archive [archivePath]")
-	.description("Import an X/Twitter archive into the local SQLite store")
+	.description("Import a Twitter archive into the local SQLite store")
 	.action(async (archivePath) => {
 		let resolvedArchivePath = archivePath;
 		if (!resolvedArchivePath) {
@@ -151,7 +151,7 @@ importCommand
 
 importCommand
 	.command("hydrate-profiles")
-	.description("Backfill archive-imported profiles from live X metadata")
+	.description("Backfill archive-imported profiles from live Twitter metadata")
 	.action(async () => {
 		const result = await hydrateProfilesFromX();
 		await autoSyncAfterWrite();
@@ -323,7 +323,7 @@ const dmsCommand = program.command("dms").description("Direct messages");
 
 const syncCommand = program
 	.command("sync")
-	.description("Refresh live X collections into the local store");
+	.description("Refresh live Twitter collections into the local store");
 
 for (const kind of ["likes", "bookmarks"] as const) {
 	syncCommand

package/src/components/AppNav.tsx

@@ -29,7 +29,7 @@ export function AppNav() {
 		<nav className={navClass}>
 			<div>
 				<p className={eyebrowClass}>birdclaw</p>
-				<h1 className={brandMarkClass}>Quiet signal for X.</h1>
+				<h1 className={brandMarkClass}>Quiet signal for Twitter.</h1>
 			</div>
 			<div className={navLinksClass}>
 				{links.map((link) => {

package/src/lib/mentions-live.ts

@@ -307,7 +307,7 @@ async function fetchMentionsViaXurl({
 	const [accountUser] = await lookupUsersByHandles([resolvedAccount.username]);
 	if (!accountUser?.id) {
 		throw new Error(
-			`Could not resolve X user id for @${resolvedAccount.username}`,
+			`Could not resolve Twitter user id for @${resolvedAccount.username}`,
 		);
 	}
 

package/src/lib/openai.ts

@@ -44,7 +44,7 @@ export async function scoreInboxItemWithOpenAI(
 				{
 					role: "system",
 					content:
-						"You rank inbound X mentions and DMs for Peter Steinberger. Return JSON only with keys score, summary, reasoning. Score 0-100. High score means worth replying soon. Prefer specific, actionable, novel, high-signal items. Penalize generic praise, low-context asks, and low-signal chatter. summary max 18 words. reasoning max 28 words.",
+						"You rank inbound Twitter mentions and DMs for Peter Steinberger. Return JSON only with keys score, summary, reasoning. Score 0-100. High score means worth replying soon. Prefer specific, actionable, novel, high-signal items. Penalize generic praise, low-context asks, and low-signal chatter. summary max 18 words. reasoning max 28 words.",
 				},
 				{
 					role: "user",

package/src/lib/profile-replies.ts

@@ -16,7 +16,7 @@ export async function inspectProfileReplies(
 ): Promise<ProfileRepliesResponse> {
 	const resolved = await resolveProfile(query);
 	if (!resolved.externalUserId) {
-		throw new Error(`Profile has no external X user id: ${query}`);
+		throw new Error(`Profile has no external Twitter user id: ${query}`);
 	}
 
 	const timeline = await listUserTweets(resolved.externalUserId, {

package/src/lib/timeline-collections-live.ts

@@ -248,7 +248,7 @@ async function fetchXurlCollection({
 	if (!resolvedUserId) {
 		const [accountUser] = await lookupUsersByHandles([username]);
 		if (!accountUser?.id) {
-			throw new Error(`Could not resolve X user id for @${username}`);
+			throw new Error(`Could not resolve Twitter user id for @${username}`);
 		}
 		resolvedUserId = String(accountUser.id);
 	}

package/src/lib/xurl.ts

@@ -317,13 +317,13 @@ export async function listMentionsViaXurl({
 		if (username) {
 			const [user] = await lookupUsersByHandles([username]);
 			if (!user?.id) {
-				throw new Error(`Could not resolve X user id for @${username}`);
+				throw new Error(`Could not resolve Twitter user id for @${username}`);
 			}
 			resolvedUserId = String(user.id);
 		} else {
 			const user = await lookupAuthenticatedUser();
 			if (!user?.id) {
-				throw new Error("Could not resolve authenticated X user id");
+				throw new Error("Could not resolve authenticated Twitter user id");
 			}
 			resolvedUserId = String(user.id);
 		}
@@ -376,13 +376,13 @@ async function listTimelineCollectionViaXurl({
 		if (username) {
 			const [user] = await lookupUsersByHandles([username]);
 			if (!user?.id) {
-				throw new Error(`Could not resolve X user id for @${username}`);
+				throw new Error(`Could not resolve Twitter user id for @${username}`);
 			}
 			resolvedUserId = String(user.id);
 		} else {
 			const user = await lookupAuthenticatedUser();
 			if (!user?.id) {
-				throw new Error("Could not resolve authenticated X user id");
+				throw new Error("Could not resolve authenticated Twitter user id");
 			}
 			resolvedUserId = String(user.id);
 		}

package/src/routes/blocks.tsx

@@ -240,7 +240,7 @@ function BlocksRoute() {
 						className={cx(textFieldClass, textFieldWideClass)}
 						disabled={!hasAccountId}
 						onChange={(event) => setSearch(event.target.value)}
-						placeholder="Handle, name, bio, or X URL"
+						placeholder="Handle, name, bio, or Twitter URL"
 						value={search}
 					/>
 					<button