birdclaw 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # CHANGELOG
 
+## 0.11.0 - 2026-07-18
+
+### Highlights
+
+- Choose an existing account independently for each live operation without changing the database's persistent account identity.
+- Start a fully local sample archive with `init --demo` for immediate zero-auth exploration.
+
+### Added
+
+- Select existing accounts per live operation with `--account <username>` or `accounts.default`, including sync, profile hydration, DMs, compose, moderation, and scheduled jobs, without changing persistent database identity. (idea from #97 - thanks @ivankuznetsov)
+- Add explicit `init --demo` sample data for zero-auth offline exploration while keeping normal initialization empty.
+
+### Fixed
+
+- Keep `birdclaw db stats` local-only so it does not block on unrelated macOS archive discovery.
+
+### Dependencies and maintenance
+
+- Update `lucide-react` to 1.25.0, `@tanstack/react-start` to 1.168.30, and the pnpm 10 release pin to 10.34.5.
+
 ## 0.10.0 - 2026-07-17
 
 ### Highlights

package/README.md

@@ -224,6 +224,8 @@ birdclaw auth status --json
 birdclaw db stats --json
 ```
 
+Want to explore before importing an archive or signing in? `birdclaw init --demo` fills the local database with sample tweets, DMs, profiles, and links. It makes no network requests; run `birdclaw serve` afterward to browse the demo.
+
 `auth status` reports Birdclaw's coarse xurl status. Verify xurl with `xurl whoami`. If you already have a private bird installation, verify it with `bird whoami`. For setup and transport selection, see [Sign in](docs/auth.md).
 
 Find and import an archive:
@@ -234,14 +236,16 @@ birdclaw import archive --json
 birdclaw import archive ~/Downloads/twitter-archive-2025.zip --json
 ```
 
-Don't have an archive yet? Request it from <https://x.com/settings/download_your_data>; X emails a download link when it is ready, which may take a few days. A fresh Birdclaw database needs the archive import to establish account identity before live sync. See [Archive Import → Get an archive](docs/archive.md#get-an-archive).
+Don't have an archive yet? Request it from <https://x.com/settings/download_your_data>; X emails a download link when it is ready, which may take a few days. A fresh or demo Birdclaw database needs the archive import to establish real account identity before live sync. See [Archive Import → Get an archive](docs/archive.md#get-an-archive).
 
 Optional profile hydration through xurl can improve bios, follower counts, and avatars, but it performs live X profile reads and can spend API credits on large archives. With an existing private bird installation, the command can instead correct the seeded local account identity from `bird whoami` without bulk-hydrating imported profiles:
 
 ```bash
-birdclaw import hydrate-profiles --json
+birdclaw import hydrate-profiles --account steipete --json
 ```
 
+Every command that touches live account auth accepts `--account <username>` (stored IDs also work). To reuse one selection without changing the database identity, set `{"accounts":{"default":"steipete"}}` in `~/.birdclaw/config.json`; an explicit flag overrides it for one operation.
+
 `import archive` is idempotent. Re-running parses follower/following edges into the local follow graph, streams bundled media files under `data/tweets_media/`, `data/direct_messages_media/`, and the other archive media folders into `~/.birdclaw/media/originals/archive/<kind>/<id>/`, and pulls `video_info.variants[]` so archive video and animated-GIF rows carry mp4 URLs for the live media fetcher. Already-extracted files are skipped when size matches.
 
 Re-import only one part of a newer archive when you already have live or local data you want to keep: