diff --git a/CHANGELOG.md b/CHANGELOG.md
index d0a5edd..90675c3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,10 @@
 
 ## 0.2.0 — Unreleased
 
+### Added
+- Output controls: `--plain`, `--no-emoji`, `--no-color` (respects `NO_COLOR`).
+- `help` command: `bird help <command>`.
+
 ### Fixed
 - CLI `--version`: read version from `package.json`/`VERSION` (no hardcoded string) + append git sha when available.
 
diff --git a/README.md b/README.md
index 09f14d8..c4c47b6 100644
--- a/README.md
+++ b/README.md
@@ -16,6 +16,9 @@ pnpm add -g @steipete/bird
 # Show the logged-in account
 bird whoami
 
+# Discover command help
+bird help whoami
+
 # Read a tweet (URL or ID)
 bird read https://x.com/user/status/1234567890123456789
 bird 1234567890123456789 --json
@@ -98,6 +101,11 @@ Environment shortcuts:
 - `read` returns full text for Notes and Articles when present.
 - Use `--plain` for stable, script-friendly output (no emoji, no color).
 
+Exit codes:
+- `0`: success
+- `1`: runtime error (network/auth/etc)
+- `2`: invalid usage/validation (e.g. bad `--user` handle)
+
 ## Version
 
 `bird --version` prints `package.json` version plus current git sha when available, e.g. `0.2.0 (3df7969b)`.
@@ -123,6 +131,7 @@ pnpm run build:dist  # dist/ only
 pnpm run build:binary
 
 pnpm run dev tweet "Test"
+pnpm run dev -- --plain check
 pnpm test
 pnpm run lint
 ```