typefully 0.2.0 → 0.3.0

package/README.md

@@ -48,6 +48,7 @@ typefully setup
 tfly                              # interactive — pick text, platform, schedule
 tfly "Hello, world!"              # instant draft from text
 
+tfly schedule                     # interactive — browse drafts and schedule one
 tfly rm                           # interactive — pick drafts to delete
 tfly rm <draft_id>                # delete a specific draft
 
@@ -104,6 +105,8 @@ typefully config set-default 123 --location global
 typefully config set-default 123 --scope local         # --scope is an alias for --location
 typefully config set-platforms                         # interactive multiselect
 typefully config set-platforms --platforms x,linkedin,threads
+typefully config set-timezone                          # interactive — pick from common IANA timezones
+typefully config set-timezone --timezone America/New_York
 ```
 
 ### User & Social Sets
@@ -114,6 +117,19 @@ typefully social-sets list
 typefully social-sets get [social_set_id]
 ```
 
+### Interactive Scheduler
+
+```bash
+tfly schedule
+```
+
+Browse all drafts and schedule one with a keyboard-only flow:
+
+- **Happy path** — `↑↓ Enter` pick draft → `Enter` next free slot → `Enter` confirm → `Enter` open in browser
+- **Custom time** — select "Custom date & time", enter date (`YYYY-MM-DD`) and time (`HH:MM`), confirm
+
+Timezone defaults to PST. Change it with `tfly config set-timezone`.
+
 ### Drafts
 
 ```bash
@@ -207,7 +223,8 @@ Config files are stored as JSON with `0600` permissions:
 {
   "apiKey": "typ_xxxx",
   "defaultSocialSetId": 12345,
-  "defaultPlatforms": ["x", "linkedin"]
+  "defaultPlatforms": ["x", "linkedin"],
+  "defaultTimezone": "America/Los_Angeles"
 }
 ```
 

package/dist/index.js

@@ -21,7 +21,8 @@ import { z } from "zod/v4";
 var ConfigSchema = z.object({
   apiKey: z.string().optional(),
   defaultSocialSetId: z.union([z.string(), z.number()]).optional(),
-  defaultPlatforms: z.array(z.string()).optional()
+  defaultPlatforms: z.array(z.string()).optional(),
+  defaultTimezone: z.string().optional()
 });
 var PLATFORMS = ["x", "linkedin", "threads", "bluesky", "mastodon"];
 
@@ -165,6 +166,26 @@ function getGlobalConfigFile() {
 function getLocalConfigFile() {
   return path.join(process.cwd(), LOCAL_CONFIG_FILE);
 }
+var DEFAULT_TIMEZONE = "America/Los_Angeles";
+function getDefaultTimezone() {
+  const localPath = path.join(process.cwd(), LOCAL_CONFIG_FILE);
+  const localConfig = readConfigFile(localPath);
+  if (localConfig?.defaultTimezone) return localConfig.defaultTimezone;
+  const globalConfig = readConfigFile(GLOBAL_CONFIG_FILE);
+  if (globalConfig?.defaultTimezone) return globalConfig.defaultTimezone;
+  return DEFAULT_TIMEZONE;
+}
+function tzLabel(tz) {
+  try {
+    const parts = new Intl.DateTimeFormat("en-US", {
+      timeZone: tz,
+      timeZoneName: "short"
+    }).formatToParts(/* @__PURE__ */ new Date());
+    return parts.find((p4) => p4.type === "timeZoneName")?.value ?? tz;
+  } catch {
+    return tz;
+  }
+}
 
 // src/utils/output.ts
 import ora from "ora";
@@ -196,9 +217,9 @@ var NOOP_SPINNER = {
   fail() {
   }
 };
-function spin(text5) {
+function spin(text6) {
   if (isJsonMode()) return NOOP_SPINNER;
-  return ora({ text: text5, color: "cyan" });
+  return ora({ text: text6, color: "cyan" });
 }
 
 // src/utils/api.ts
@@ -219,12 +240,12 @@ async function apiRequest(method, endpoint, body, opts = {}) {
   }
   const res = await fetch(url, fetchOpts);
   if (!res.ok) {
-    const text6 = await res.text().catch(() => "");
+    const text7 = await res.text().catch(() => "");
     let parsed;
     try {
-      parsed = JSON.parse(text6);
+      parsed = JSON.parse(text7);
     } catch {
-      parsed = text6;
+      parsed = text7;
     }
     if (exitOnError) {
       console.error(JSON.stringify({ error: `HTTP ${res.status}`, response: parsed }, null, 2));
@@ -235,12 +256,12 @@ async function apiRequest(method, endpoint, body, opts = {}) {
     err.status = res.status;
     throw err;
   }
-  const text5 = await res.text();
-  if (!text5) return {};
+  const text6 = await res.text();
+  if (!text6) return {};
   try {
-    return JSON.parse(text5);
+    return JSON.parse(text6);
   } catch {
-    return text5;
+    return text6;
   }
 }
 function sleep(ms) {
@@ -250,8 +271,8 @@ function sleep(ms) {
 // src/utils/helpers.ts
 import path2 from "path";
 import pc2 from "picocolors";
-function splitThreadText(text5) {
-  return text5.split(/\r?\n[ \t]*---[ \t]*\r?\n/).filter((t) => t.trim());
+function splitThreadText(text6) {
+  return text6.split(/\r?\n[ \t]*---[ \t]*\r?\n/).filter((t) => t.trim());
 }
 function sanitizeFilename(filename) {
   const ext = path2.extname(filename).toLowerCase();
@@ -430,10 +451,10 @@ function registerDraftsCommand(program2) {
     if (opts.status) params.set("status", opts.status);
     if (opts.tag) params.set("tag", opts.tag);
     if (opts.sort) params.set("order_by", opts.sort);
-    const spinner3 = spin("Fetching drafts\u2026");
-    spinner3.start();
+    const spinner4 = spin("Fetching drafts\u2026");
+    spinner4.start();
     const data = await apiRequest("GET", `/social-sets/${id}/drafts?${params}`);
-    spinner3.stop();
+    spinner4.stop();
     display(data, () => renderDraftsList(data));
   });
   cmd.command("get").description("Get a specific draft").argument("[first_arg]", "social_set_id or draft_id").argument("[second_arg]", "draft_id (when first arg is social_set_id)").option("--social-set-id <id>", "Social set ID via flag (first arg becomes draft_id)").option("--use-default", "Confirm using default social set").action(
@@ -445,22 +466,22 @@ function registerDraftsCommand(program2) {
         !!opts.useDefault,
         opts.socialSetId
       );
-      const spinner3 = spin("Fetching draft\u2026");
-      spinner3.start();
+      const spinner4 = spin("Fetching draft\u2026");
+      spinner4.start();
       const data = await apiRequest("GET", `/social-sets/${socialSetId}/drafts/${draftId}`);
-      spinner3.stop();
+      spinner4.stop();
       display(data, () => renderDraft(data));
     }
   );
   cmd.command("create").description("Create a new draft").argument("[social_set_id]", "Social set ID (uses default if omitted)").option("--social-set-id <id>", "Social set ID via flag (overrides positional)").option("--text <text>", "Post content (use --- on its own line for threads)").option("-f, --file <path>", "Read content from file").option("--platform <platforms>", "Comma-separated platforms").option("--all", "Post to all connected platforms").option("--media <media_ids>", "Comma-separated media IDs").option("--title <title>", "Draft title (internal only)").option("--schedule <time>", '"now", "next-free-slot", or ISO datetime').option("--tags <tags>", "Comma-separated tag slugs").option("--reply-to <url>", "URL of X post to reply to").option("--community <id>", "X community ID").option("--share", "Generate a public share URL").option("--scratchpad <text>", "Internal notes/scratchpad").option("--notes <text>", "Internal notes/scratchpad (alias for --scratchpad)").action(async (socialSetId, opts) => {
     const id = resolveSocialSetId(opts.socialSetId ?? socialSetId);
-    let text5 = opts.text;
+    let text6 = opts.text;
     if (opts.file) {
       const filePath = opts.file;
       if (!fs2.existsSync(filePath)) exitWithError(`File not found: ${filePath}`);
-      text5 = fs2.readFileSync(filePath, "utf-8");
+      text6 = fs2.readFileSync(filePath, "utf-8");
     }
-    if (!text5) exitWithError("--text or --file is required");
+    if (!text6) exitWithError("--text or --file is required");
     if (opts.all && opts.platform) {
       exitWithError("Cannot use both --all and --platform flags");
     }
@@ -470,12 +491,12 @@ function registerDraftsCommand(program2) {
       if (allPlatforms.length === 0) exitWithError("No connected platforms found");
       platformList = [...allPlatforms];
     } else if (opts.platform) {
-      platformList = opts.platform.split(",").map((p3) => p3.trim());
+      platformList = opts.platform.split(",").map((p4) => p4.trim());
     } else {
       const saved = getDefaultPlatforms();
       if (saved?.length) {
         const connected = await getAllConnectedPlatforms(id);
-        platformList = saved.filter((p3) => connected.includes(p3));
+        platformList = saved.filter((p4) => connected.includes(p4));
         if (platformList.length === 0) platformList = [...connected];
       } else {
         const defaultPlatform = await getFirstConnectedPlatform(id);
@@ -483,7 +504,7 @@ function registerDraftsCommand(program2) {
         platformList = [defaultPlatform];
       }
     }
-    const posts = splitThreadText(text5);
+    const posts = splitThreadText(text6);
     const mediaIds = opts.media ? opts.media.split(",").map((m) => m.trim()) : [];
     const postsArray = posts.map((postText, index) => {
       const post = { text: postText };
@@ -510,10 +531,10 @@ function registerDraftsCommand(program2) {
     if (opts.share) body.share = true;
     const scratchpad = opts.notes ?? opts.scratchpad;
     if (scratchpad) body.scratchpad_text = scratchpad;
-    const spinner3 = spin("Creating draft\u2026");
-    spinner3.start();
+    const spinner4 = spin("Creating draft\u2026");
+    spinner4.start();
     const data = await apiRequest("POST", `/social-sets/${id}/drafts`, body);
-    spinner3.stop();
+    spinner4.stop();
     display(data, () => renderDraft(data, "Draft created"));
   });
   cmd.command("update").description("Update an existing draft").argument("[first_arg]", "social_set_id or draft_id").argument("[second_arg]", "draft_id (when first arg is social_set_id)").option("--social-set-id <id>", "Social set ID via flag (first arg becomes draft_id)").option("--text <text>", "New post content").option("-f, --file <path>", "Read content from file").option("--platform <platforms>", "Comma-separated platforms").option("--media <media_ids>", "Comma-separated media IDs").option("-a, --append", "Append to existing thread").option("--title <title>", "New draft title").option("--schedule <time>", '"now", "next-free-slot", or ISO datetime').option("--tags <tags>", "Comma-separated tag slugs").option("--share", "Generate a public share URL").option("--scratchpad <text>", "Internal notes/scratchpad").option("--notes <text>", "Internal notes/scratchpad (alias for --scratchpad)").option("--use-default", "Confirm using default social set").action(
@@ -525,14 +546,14 @@ function registerDraftsCommand(program2) {
         !!opts.useDefault,
         opts.socialSetId
       );
-      let text5 = opts.text;
+      let text6 = opts.text;
       if (opts.file) {
         const filePath = opts.file;
         if (!fs2.existsSync(filePath)) exitWithError(`File not found: ${filePath}`);
-        text5 = fs2.readFileSync(filePath, "utf-8");
+        text6 = fs2.readFileSync(filePath, "utf-8");
       }
       const body = {};
-      if (text5) {
+      if (text6) {
         const mediaIds = opts.media ? opts.media.split(",").map((m) => m.trim()) : [];
         const existing = await apiRequest(
           "GET",
@@ -540,7 +561,7 @@ function registerDraftsCommand(program2) {
         );
         let platformList;
         if (opts.platform) {
-          platformList = opts.platform.split(",").map((p3) => p3.trim());
+          platformList = opts.platform.split(",").map((p4) => p4.trim());
         } else {
           const existingPlatforms = existing.platforms;
           platformList = Object.entries(existingPlatforms ?? {}).filter(([, config]) => config.enabled).map(([platform]) => platform);
@@ -560,11 +581,11 @@ function registerDraftsCommand(program2) {
               break;
             }
           }
-          const newPost = { text: text5 };
+          const newPost = { text: text6 };
           if (mediaIds.length > 0) newPost.media_ids = mediaIds;
           postsArray = [...existingPosts, newPost];
         } else {
-          const posts = splitThreadText(text5);
+          const posts = splitThreadText(text6);
           postsArray = posts.map((postText, index) => {
             const post = { text: postText };
             if (index === 0 && mediaIds.length > 0) post.media_ids = mediaIds;
@@ -572,8 +593,8 @@ function registerDraftsCommand(program2) {
           });
         }
         const platformsObj = {};
-        for (const p3 of platformList) {
-          platformsObj[p3] = { enabled: true, posts: postsArray };
+        for (const p4 of platformList) {
+          platformsObj[p4] = { enabled: true, posts: postsArray };
         }
         body.platforms = platformsObj;
       }
@@ -590,14 +611,14 @@ function registerDraftsCommand(program2) {
           "At least one option is required (--text, --file, --title, --schedule, --share, --scratchpad/--notes, or --tags)"
         );
       }
-      const spinner3 = spin("Updating draft\u2026");
-      spinner3.start();
+      const spinner4 = spin("Updating draft\u2026");
+      spinner4.start();
       const data = await apiRequest(
         "PATCH",
         `/social-sets/${socialSetId}/drafts/${draftId}`,
         body
       );
-      spinner3.stop();
+      spinner4.stop();
       display(data, () => renderDraft(data, "Draft updated"));
     }
   );
@@ -610,10 +631,10 @@ function registerDraftsCommand(program2) {
         !!opts.useDefault,
         opts.socialSetId
       );
-      const spinner3 = spin("Deleting draft\u2026");
-      spinner3.start();
+      const spinner4 = spin("Deleting draft\u2026");
+      spinner4.start();
       await apiRequest("DELETE", `/social-sets/${socialSetId}/drafts/${draftId}`);
-      spinner3.succeed("Draft deleted");
+      spinner4.succeed("Draft deleted");
       display({ success: true, message: "Draft deleted" }, () => {
       });
     }
@@ -628,12 +649,12 @@ function registerDraftsCommand(program2) {
         opts.socialSetId
       );
       if (!opts.time) exitWithError('--time is required (use "next-free-slot" or ISO datetime)');
-      const spinner3 = spin("Scheduling draft\u2026");
-      spinner3.start();
+      const spinner4 = spin("Scheduling draft\u2026");
+      spinner4.start();
       const data = await apiRequest("PATCH", `/social-sets/${socialSetId}/drafts/${draftId}`, {
         publish_at: opts.time
       });
-      spinner3.stop();
+      spinner4.stop();
       display(data, () => renderDraft(data, "Draft scheduled"));
     }
   );
@@ -646,12 +667,12 @@ function registerDraftsCommand(program2) {
         !!opts.useDefault,
         opts.socialSetId
       );
-      const spinner3 = spin("Publishing draft\u2026");
-      spinner3.start();
+      const spinner4 = spin("Publishing draft\u2026");
+      spinner4.start();
       const data = await apiRequest("PATCH", `/social-sets/${socialSetId}/drafts/${draftId}`, {
         publish_at: "now"
       });
-      spinner3.stop();
+      spinner4.stop();
       display(data, () => renderDraft(data, "Draft published"));
     }
   );
@@ -661,15 +682,15 @@ function registerDraftsCommand(program2) {
 function registerAliasCommands(program2) {
   program2.command("create-draft").description('Create a draft \u2014 alias for "drafts create" with positional text').argument("[text]", "Draft text (or use --text/--file)").option("--social-set-id <id>", "Social set ID (uses default if omitted)").option("--text <text>", "Post content (overrides positional text)").option("-f, --file <path>", "Read content from file").option("--platform <platforms>", "Comma-separated platforms").option("--all", "Post to all connected platforms").option("--media <media_ids>", "Comma-separated media IDs").option("--title <title>", "Draft title (internal only)").option("--schedule <time>", '"now", "next-free-slot", or ISO datetime').option("--tags <tags>", "Comma-separated tag slugs").option("--reply-to <url>", "URL of X post to reply to").option("--community <id>", "X community ID").option("--share", "Generate a public share URL").option("--scratchpad <text>", "Internal notes/scratchpad").option("--notes <text>", "Internal notes/scratchpad (alias for --scratchpad)").action(async (positionalText, opts) => {
     const id = requireSocialSetId(opts.socialSetId ?? null);
-    let text5;
+    let text6;
     if (opts.file) {
       const filePath = opts.file;
       if (!fs3.existsSync(filePath)) exitWithError(`File not found: ${filePath}`);
-      text5 = fs3.readFileSync(filePath, "utf-8");
+      text6 = fs3.readFileSync(filePath, "utf-8");
     } else {
-      text5 = opts.text ?? positionalText;
+      text6 = opts.text ?? positionalText;
     }
-    if (!text5)
+    if (!text6)
       exitWithError("Draft text is required (provide as argument, or use --text/--file)");
     if (opts.all && opts.platform) exitWithError("Cannot use both --all and --platform flags");
     let platformList;
@@ -678,12 +699,12 @@ function registerAliasCommands(program2) {
       if (allPlatforms.length === 0) exitWithError("No connected platforms found");
       platformList = [...allPlatforms];
     } else if (opts.platform) {
-      platformList = opts.platform.split(",").map((p3) => p3.trim());
+      platformList = opts.platform.split(",").map((p4) => p4.trim());
     } else {
       const saved = getDefaultPlatforms();
       if (saved?.length) {
         const connected = await getAllConnectedPlatforms(id);
-        platformList = saved.filter((p3) => connected.includes(p3));
+        platformList = saved.filter((p4) => connected.includes(p4));
         if (platformList.length === 0) platformList = [...connected];
       } else {
         const defaultPlatform = await getFirstConnectedPlatform(id);
@@ -691,7 +712,7 @@ function registerAliasCommands(program2) {
         platformList = [defaultPlatform];
       }
     }
-    const posts = splitThreadText(text5);
+    const posts = splitThreadText(text6);
     const mediaIds = opts.media ? opts.media.split(",").map((m) => m.trim()) : [];
     const postsArray = posts.map((postText, index) => {
       const post = { text: postText };
@@ -716,25 +737,25 @@ function registerAliasCommands(program2) {
     if (opts.share) body.share = true;
     const scratchpad = opts.notes ?? opts.scratchpad;
     if (scratchpad) body.scratchpad_text = scratchpad;
-    const spinner3 = spin("Creating draft\u2026");
-    spinner3.start();
+    const spinner4 = spin("Creating draft\u2026");
+    spinner4.start();
     const data = await apiRequest("POST", `/social-sets/${id}/drafts`, body);
-    spinner3.stop();
+    spinner4.stop();
     display(data, () => renderDraft(data, "Draft created"));
   });
   program2.command("update-draft").description('Update a draft \u2014 alias for "drafts update" with positional draft_id').argument("<draft_id>", "Draft ID").argument("[text]", "New draft text (or use --text/--file)").option("--social-set-id <id>", "Social set ID (uses default if omitted)").option("--text <text>", "New post content (overrides positional text)").option("-f, --file <path>", "Read content from file").option("--platform <platforms>", "Comma-separated platforms").option("--media <media_ids>", "Comma-separated media IDs").option("-a, --append", "Append to existing thread").option("--title <title>", "New draft title").option("--schedule <time>", '"now", "next-free-slot", or ISO datetime').option("--tags <tags>", "Comma-separated tag slugs").option("--share", "Generate a public share URL").option("--scratchpad <text>", "Internal notes/scratchpad").option("--notes <text>", "Internal notes/scratchpad (alias for --scratchpad)").action(
     async (draftId, positionalText, opts) => {
       const socialSetId = requireSocialSetId(opts.socialSetId ?? null);
-      let text5;
+      let text6;
       if (opts.file) {
         const filePath = opts.file;
         if (!fs3.existsSync(filePath)) exitWithError(`File not found: ${filePath}`);
-        text5 = fs3.readFileSync(filePath, "utf-8");
+        text6 = fs3.readFileSync(filePath, "utf-8");
       } else {
-        text5 = opts.text ?? positionalText;
+        text6 = opts.text ?? positionalText;
       }
       const body = {};
-      if (text5) {
+      if (text6) {
         const mediaIds = opts.media ? opts.media.split(",").map((m) => m.trim()) : [];
         const existing = await apiRequest(
           "GET",
@@ -742,7 +763,7 @@ function registerAliasCommands(program2) {
         );
         let platformList;
         if (opts.platform) {
-          platformList = opts.platform.split(",").map((p3) => p3.trim());
+          platformList = opts.platform.split(",").map((p4) => p4.trim());
         } else {
           const existingPlatforms = existing.platforms;
           platformList = Object.entries(existingPlatforms ?? {}).filter(([, config]) => config.enabled).map(([platform]) => platform);
@@ -762,11 +783,11 @@ function registerAliasCommands(program2) {
               break;
             }
           }
-          const newPost = { text: text5 };
+          const newPost = { text: text6 };
           if (mediaIds.length > 0) newPost.media_ids = mediaIds;
           postsArray = [...existingPosts, newPost];
         } else {
-          const posts = splitThreadText(text5);
+          const posts = splitThreadText(text6);
           postsArray = posts.map((postText, index) => {
             const post = { text: postText };
             if (index === 0 && mediaIds.length > 0) post.media_ids = mediaIds;
@@ -774,8 +795,8 @@ function registerAliasCommands(program2) {
           });
         }
         const platformsObj = {};
-        for (const p3 of platformList) {
-          platformsObj[p3] = { enabled: true, posts: postsArray };
+        for (const p4 of platformList) {
+          platformsObj[p4] = { enabled: true, posts: postsArray };
         }
         body.platforms = platformsObj;
       }
@@ -790,24 +811,24 @@ function registerAliasCommands(program2) {
           "At least one option is required (--text, --file, --title, --schedule, --share, --scratchpad/--notes, or --tags)"
         );
       }
-      const spinner3 = spin("Updating draft\u2026");
-      spinner3.start();
+      const spinner4 = spin("Updating draft\u2026");
+      spinner4.start();
       const data = await apiRequest(
         "PATCH",
         `/social-sets/${socialSetId}/drafts/${draftId}`,
         body
       );
-      spinner3.stop();
+      spinner4.stop();
       display(data, () => renderDraft(data, "Draft updated"));
     }
   );
   program2.command("rm").description("Delete a draft \u2014 provide draft_id or pick interactively").argument("[draft_id]", "Draft ID to delete (omit for interactive picker)").option("--social-set-id <id>", "Social set ID (uses default if omitted)").option("--status <status>", "Filter drafts by status in picker (default: draft)").option("--limit <n>", "Max drafts to show in picker (default: 20)").action(async (draftId, opts) => {
     const socialSetId = requireSocialSetId(opts.socialSetId ?? null);
     if (draftId) {
-      const spinner3 = spin("Deleting draft\u2026");
-      spinner3.start();
+      const spinner4 = spin("Deleting draft\u2026");
+      spinner4.start();
       await apiRequest("DELETE", `/social-sets/${socialSetId}/drafts/${draftId}`);
-      spinner3.succeed("Draft deleted");
+      spinner4.succeed("Draft deleted");
       display({ success: true, message: "Draft deleted" }, () => {
       });
       return;
@@ -854,11 +875,11 @@ function registerAliasCommands(program2) {
       process.exit(0);
     }
     const ids = selected;
-    const confirm3 = await p.confirm({
+    const confirm4 = await p.confirm({
       message: `Delete ${ids.length} draft${ids.length !== 1 ? "s" : ""}?`,
       initialValue: false
     });
-    if (p.isCancel(confirm3) || !confirm3) {
+    if (p.isCancel(confirm4) || !confirm4) {
       p.cancel("Cancelled.");
       process.exit(0);
     }
@@ -901,6 +922,8 @@ function renderConfigShow(data) {
   } else {
     console.log(pc5.dim("  Default platforms: not set  \xB7  Run: typefully config set-platforms"));
   }
+  const tz = getDefaultTimezone();
+  console.log(pc5.dim(`  Default timezone: ${tz} (${tzLabel(tz)})`));
   console.log("");
 }
 function registerConfigCommand(program2) {
@@ -942,10 +965,10 @@ function registerConfigCommand(program2) {
     let socialSetId = socialSetIdArg;
     let location = opts.scope ?? opts.location;
     if (!socialSetId) {
-      const spinner3 = spin("Fetching social sets\u2026");
-      spinner3.start();
+      const spinner4 = spin("Fetching social sets\u2026");
+      spinner4.start();
       const socialSets = await apiRequest("GET", "/social-sets?limit=50");
-      spinner3.stop();
+      spinner4.stop();
       const results = socialSets.results;
       if (!results || results.length === 0) {
         exitWithError("No social sets found. Create one at typefully.com first.");
@@ -1016,10 +1039,100 @@ function registerConfigCommand(program2) {
       console.log("");
     });
   });
+  cmd.command("set-timezone").description("Set default timezone for scheduling").option("--timezone <tz>", "IANA timezone name (skips interactive)").option("--location <location>", "Storage location: global or local").option("--scope <scope>", "Alias for --location").action(async (opts) => {
+    const COMMON_TIMEZONES = [
+      { value: "America/Los_Angeles", label: "America/Los_Angeles", hint: "PST/PDT" },
+      { value: "America/Denver", label: "America/Denver", hint: "MST/MDT" },
+      { value: "America/Chicago", label: "America/Chicago", hint: "CST/CDT" },
+      { value: "America/New_York", label: "America/New_York", hint: "EST/EDT" },
+      { value: "America/Sao_Paulo", label: "America/Sao_Paulo", hint: "BRT" },
+      { value: "Europe/London", label: "Europe/London", hint: "GMT/BST" },
+      { value: "Europe/Paris", label: "Europe/Paris", hint: "CET/CEST" },
+      { value: "Europe/Istanbul", label: "Europe/Istanbul", hint: "TRT" },
+      { value: "Asia/Dubai", label: "Asia/Dubai", hint: "GST" },
+      { value: "Asia/Karachi", label: "Asia/Karachi", hint: "PKT" },
+      { value: "Asia/Kolkata", label: "Asia/Kolkata", hint: "IST" },
+      { value: "Asia/Shanghai", label: "Asia/Shanghai", hint: "CST" },
+      { value: "Asia/Tokyo", label: "Asia/Tokyo", hint: "JST" },
+      { value: "Australia/Sydney", label: "Australia/Sydney", hint: "AEST/AEDT" },
+      { value: "custom", label: "Custom IANA timezone\u2026", hint: "enter manually" }
+    ];
+    let timezone;
+    if (opts.timezone) {
+      timezone = opts.timezone;
+    } else {
+      const current = getDefaultTimezone();
+      const tzChoice = await clack2.select({
+        message: "Default timezone for scheduling",
+        initialValue: COMMON_TIMEZONES.some((t) => t.value === current) ? current : "custom",
+        options: COMMON_TIMEZONES
+      });
+      if (clack2.isCancel(tzChoice)) {
+        clack2.cancel("Cancelled.");
+        process.exit(0);
+      }
+      if (tzChoice === "custom") {
+        const customTz = await clack2.text({
+          message: "Enter IANA timezone name",
+          placeholder: DEFAULT_TIMEZONE,
+          validate: (v = "") => {
+            if (!v.trim()) return "Timezone is required";
+            try {
+              Intl.DateTimeFormat(void 0, { timeZone: v });
+            } catch {
+              return `Invalid timezone: ${v}`;
+            }
+          }
+        });
+        if (clack2.isCancel(customTz)) {
+          clack2.cancel("Cancelled.");
+          process.exit(0);
+        }
+        timezone = customTz;
+      } else {
+        timezone = tzChoice;
+      }
+    }
+    let location = opts.scope ?? opts.location;
+    if (!location) {
+      const choice = await clack2.select({
+        message: "Where should this be stored?",
+        options: [
+          {
+            value: "global",
+            label: `Global ${pc5.dim("(~/.config/typefully/)")}`,
+            hint: "all projects"
+          },
+          {
+            value: "local",
+            label: `Local ${pc5.dim("(./.typefully/)")}`,
+            hint: "this project only"
+          }
+        ]
+      });
+      if (clack2.isCancel(choice)) {
+        clack2.cancel("Cancelled.");
+        process.exit(0);
+      }
+      location = choice;
+    }
+    const isLocal = location === "local";
+    const configPath = isLocal ? getLocalConfigFile() : getGlobalConfigFile();
+    const existingConfig = readConfigFile(configPath) ?? {};
+    writeConfig(configPath, { ...existingConfig, defaultTimezone: timezone });
+    display({ success: true, default_timezone: timezone, config_path: configPath }, () => {
+      console.log("");
+      console.log(
+        `  ${pc5.green("\u2713")} Default timezone saved: ${pc5.bold(timezone)} ${pc5.dim(`(${tzLabel(timezone)})`)}`
+      );
+      console.log(pc5.dim(`  Config: ${configPath}`));
+      console.log("");
+    });
+  });
   cmd.command("set-platforms").description("Set default platforms for new drafts").option("--platforms <platforms>", "Comma-separated platforms (skips interactive)").option("--location <location>", "Storage location: global or local").option("--scope <scope>", "Alias for --location").action(async (opts) => {
     let platformList;
     if (opts.platforms) {
-      platformList = opts.platforms.split(",").map((p3) => p3.trim());
+      platformList = opts.platforms.split(",").map((p4) => p4.trim());
     } else {
       const selected = await clack2.multiselect({
         message: "Default platforms for new drafts",
@@ -1075,28 +1188,28 @@ function registerConfigCommand(program2) {
 
 // src/commands/interactive.ts
 import * as p2 from "@clack/prompts";
-async function createDraftDirect(text5) {
+async function createDraftDirect(text6) {
   const id = requireSocialSetId(null);
   let platformList;
   const saved = getDefaultPlatforms();
   if (saved?.length) {
     const connected = await getAllConnectedPlatforms(id);
-    platformList = saved.filter((p3) => connected.includes(p3));
+    platformList = saved.filter((p4) => connected.includes(p4));
     if (platformList.length === 0) platformList = [...connected];
   } else {
     const platform = await getFirstConnectedPlatform(id);
     if (!platform) exitWithError("No connected platforms found. Run: typefully setup");
     platformList = [platform];
   }
-  const posts = splitThreadText(text5);
+  const posts = splitThreadText(text6);
   const postsArray = posts.map((postText) => ({ text: postText }));
   const platformsObj = {};
-  for (const p3 of platformList) platformsObj[p3] = { enabled: true, posts: postsArray };
+  for (const p4 of platformList) platformsObj[p4] = { enabled: true, posts: postsArray };
   const body = { platforms: platformsObj };
-  const spinner3 = spin("Creating draft\u2026");
-  spinner3.start();
+  const spinner4 = spin("Creating draft\u2026");
+  spinner4.start();
   const data = await apiRequest("POST", `/social-sets/${id}/drafts`, body);
-  spinner3.stop();
+  spinner4.stop();
   display(data, () => renderDraft(data, "Draft created"));
 }
 async function createDraftInteractive() {
@@ -1110,14 +1223,14 @@ async function createDraftInteractive() {
     p2.cancel("Cancelled.");
     process.exit(0);
   }
-  const text5 = textResult;
+  const text6 = textResult;
   let availablePlatforms = [];
   try {
     availablePlatforms = await getAllConnectedPlatforms(id);
   } catch {
   }
   const savedPlatforms = getDefaultPlatforms();
-  const defaultInitial = savedPlatforms?.length ? availablePlatforms.filter((p3) => savedPlatforms.includes(p3)) : [availablePlatforms[0]];
+  const defaultInitial = savedPlatforms?.length ? availablePlatforms.filter((p4) => savedPlatforms.includes(p4)) : [availablePlatforms[0]];
   let platformList;
   if (availablePlatforms.length > 1) {
     const selected = await p2.multiselect({
@@ -1155,7 +1268,7 @@ async function createDraftInteractive() {
     p2.cancel("Cancelled.");
     process.exit(0);
   }
-  const posts = splitThreadText(text5);
+  const posts = splitThreadText(text6);
   const postsArray = posts.map((postText) => ({ text: postText }));
   const platformsObj = {};
   for (const platform of platformList) {
@@ -1169,9 +1282,9 @@ async function createDraftInteractive() {
   s.stop("");
   display(data, () => renderDraft(data, "Draft created"));
 }
-async function runDraft(text5) {
-  if (text5) {
-    await createDraftDirect(text5);
+async function runDraft(text6) {
+  if (text6) {
+    await createDraftDirect(text6);
   } else {
     await createDraftInteractive();
   }
@@ -1216,10 +1329,10 @@ function renderMe(data) {
 }
 function registerMeCommand(program2) {
   program2.command("me").description("Get authenticated user info").action(async () => {
-    const spinner3 = spin("Fetching user info\u2026");
-    spinner3.start();
+    const spinner4 = spin("Fetching user info\u2026");
+    spinner4.start();
     const data = await apiRequest("GET", "/me");
-    spinner3.stop();
+    spinner4.stop();
     display(data, () => renderMe(data));
   });
 }
@@ -1244,8 +1357,8 @@ function registerMediaCommand(program2) {
         const n = Number.parseInt(raw, 10);
         return Number.isFinite(n) && n >= 0 ? n : 2e3;
       })();
-      const spinner3 = spin(`Uploading ${pc7.bold(rawFilename)}\u2026`);
-      spinner3.start();
+      const spinner4 = spin(`Uploading ${pc7.bold(rawFilename)}\u2026`);
+      spinner4.start();
       const presignedResponse = await apiRequest("POST", `/social-sets/${id}/media/upload`, {
         file_name: filename
       });
@@ -1256,14 +1369,14 @@ function registerMediaCommand(program2) {
       const fileBuffer = fs4.readFileSync(filePath);
       const uploadResponse = await fetch(uploadUrl, { method: "PUT", body: fileBuffer });
       if (!uploadResponse.ok) {
-        spinner3.fail("Upload failed");
+        spinner4.fail("Upload failed");
         exitWithError("Failed to upload file to S3", {
           http_code: uploadResponse.status,
           status_text: uploadResponse.statusText
         });
       }
       if (opts.wait === false) {
-        spinner3.succeed("Uploaded");
+        spinner4.succeed("Uploaded");
         display(
           { media_id: mediaId, message: "Upload complete. Use media status to check processing." },
           () => {
@@ -1275,7 +1388,7 @@ function registerMediaCommand(program2) {
         );
         return;
       }
-      spinner3.text = "Processing\u2026";
+      spinner4.text = "Processing\u2026";
       const startTime = Date.now();
       while (Date.now() - startTime < timeout) {
         const statusResponse = await apiRequest(
@@ -1283,7 +1396,7 @@ function registerMediaCommand(program2) {
           `/social-sets/${id}/media/${mediaId}`
         );
         if (statusResponse.status === "ready") {
-          spinner3.succeed("Media ready");
+          spinner4.succeed("Media ready");
           display({ media_id: mediaId, status: "ready", message: "Media uploaded and ready" }, () => {
             console.log("");
             console.log(`  ${pc7.green("\u2713")} Media ready  \xB7  ID: ${pc7.bold(mediaId)}`);
@@ -1292,12 +1405,12 @@ function registerMediaCommand(program2) {
           return;
         }
         if (statusResponse.status === "error" || statusResponse.status === "failed") {
-          spinner3.fail("Processing failed");
+          spinner4.fail("Processing failed");
           exitWithError("Media processing failed", { status: statusResponse });
         }
         await sleep(pollIntervalMs);
       }
-      spinner3.stop();
+      spinner4.stop();
       const timeoutResult = {
         media_id: mediaId,
         status: "processing",
@@ -1316,10 +1429,10 @@ function registerMediaCommand(program2) {
     async (mediaId, socialSetId, opts) => {
       const flagId = opts.socialSetId;
       const id = requireSocialSetId(flagId ?? socialSetId ?? null);
-      const spinner3 = spin("Checking media status\u2026");
-      spinner3.start();
+      const spinner4 = spin("Checking media status\u2026");
+      spinner4.start();
       const data = await apiRequest("GET", `/social-sets/${id}/media/${mediaId}`);
-      spinner3.stop();
+      spinner4.stop();
       display(data, () => {
         const d = data;
         const status = String(d.status ?? "unknown");
@@ -1515,21 +1628,21 @@ function registerSetupCommand(program2) {
 import pc9 from "picocolors";
 var PLATFORM_ORDER = ["x", "linkedin", "threads", "bluesky", "mastodon"];
 function renderPlatforms(platforms, indent = "  ") {
-  for (const p3 of PLATFORM_ORDER) {
-    const cfg = platforms[p3];
+  for (const p4 of PLATFORM_ORDER) {
+    const cfg = platforms[p4];
     if (!cfg) continue;
     const isConnected = cfg.connected !== false;
     const dot = isConnected ? pc9.green("\u25CF") : pc9.dim("\u25CB");
     const handle = cfg.username ? pc9.dim(` @${cfg.username}`) : "";
     const status = isConnected ? "" : pc9.dim(" (not connected)");
-    console.log(`${indent}${dot}  ${p3.padEnd(9)}${handle}${status}`);
+    console.log(`${indent}${dot}  ${p4.padEnd(9)}${handle}${status}`);
   }
-  for (const [p3, cfg] of Object.entries(platforms)) {
-    if (PLATFORM_ORDER.includes(p3)) continue;
+  for (const [p4, cfg] of Object.entries(platforms)) {
+    if (PLATFORM_ORDER.includes(p4)) continue;
     const isConnected = cfg.connected !== false;
     const dot = isConnected ? pc9.green("\u25CF") : pc9.dim("\u25CB");
     const handle = cfg.username ? pc9.dim(` @${cfg.username}`) : "";
-    console.log(`${indent}${dot}  ${p3.padEnd(9)}${handle}`);
+    console.log(`${indent}${dot}  ${p4.padEnd(9)}${handle}`);
   }
 }
 function renderSocialSetCard(set, index) {
@@ -1572,38 +1685,199 @@ function renderSocialSet(data) {
 function registerSocialSetsCommand(program2) {
   const cmd = program2.command("social-sets").description("Manage social sets");
   cmd.command("list").description("List all social sets").action(async () => {
-    const spinner3 = spin("Fetching social sets\u2026");
-    spinner3.start();
+    const spinner4 = spin("Fetching social sets\u2026");
+    spinner4.start();
     const data = await apiRequest("GET", "/social-sets?limit=50");
-    spinner3.stop();
+    spinner4.stop();
     display(data, () => renderSocialSetsList(data));
   });
   cmd.command("get").description("Get social set details").argument("[social_set_id]", "Social set ID (uses default if omitted)").action(async (socialSetId) => {
     const id = requireSocialSetId(socialSetId ?? null);
-    const spinner3 = spin("Fetching social set\u2026");
-    spinner3.start();
+    const spinner4 = spin("Fetching social set\u2026");
+    spinner4.start();
     const data = await apiRequest("GET", `/social-sets/${id}`);
-    spinner3.stop();
+    spinner4.stop();
     display(data, () => renderSocialSet(data));
   });
 }
 
-// src/commands/tags.ts
+// src/commands/schedule.ts
+import { exec } from "child_process";
+import * as p3 from "@clack/prompts";
 import pc10 from "picocolors";
+function toUTCIso(dateStr, timeStr, tz) {
+  const naiveUTC = /* @__PURE__ */ new Date(`${dateStr}T${timeStr}:00Z`);
+  const parts = new Intl.DateTimeFormat("en-US", {
+    timeZone: tz,
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: false
+  }).formatToParts(naiveUTC);
+  const get = (type) => parts.find((pt) => pt.type === type)?.value ?? "00";
+  const localISO = `${get("year")}-${get("month")}-${get("day")}T${get("hour")}:${get("minute")}:${get("second")}Z`;
+  const localDate = new Date(localISO);
+  const offset = naiveUTC.getTime() - localDate.getTime();
+  return new Date(naiveUTC.getTime() + offset).toISOString();
+}
+function todayInTimezone(tz) {
+  return (/* @__PURE__ */ new Date()).toLocaleDateString("en-CA", { timeZone: tz });
+}
+function formatScheduledAt(draft, tz) {
+  if (!draft.scheduled_at) return "";
+  try {
+    return new Date(String(draft.scheduled_at)).toLocaleString("en-US", {
+      timeZone: tz,
+      month: "short",
+      day: "numeric",
+      hour: "numeric",
+      minute: "2-digit",
+      hour12: true
+    });
+  } catch {
+    return String(draft.scheduled_at);
+  }
+}
+async function runScheduler() {
+  const id = requireSocialSetId(null);
+  const tz = getDefaultTimezone();
+  const tz_label = tzLabel(tz);
+  const fetchSpinner = p3.spinner();
+  fetchSpinner.start("Fetching drafts\u2026");
+  const data = await apiRequest("GET", `/social-sets/${id}/drafts?limit=50`);
+  const results = data.results ?? [];
+  const schedulable = results.filter((d) => d.status === "draft" || d.status === "scheduled");
+  if (schedulable.length === 0) {
+    fetchSpinner.stop("No drafts found.");
+    p3.cancel("No drafts available to schedule.");
+    process.exit(0);
+  }
+  const fullDrafts = await Promise.all(
+    schedulable.map(
+      (draft) => apiRequest("GET", `/social-sets/${id}/drafts/${draft.id}`).catch(() => draft)
+    )
+  );
+  fetchSpinner.stop(`${fullDrafts.length} draft${fullDrafts.length !== 1 ? "s" : ""} loaded`);
+  const draftChoice = await p3.select({
+    message: "Pick a draft",
+    options: fullDrafts.map((draft) => {
+      const preview = firstPostText(draft, 65) || pc10.dim("(no text)");
+      const status = String(draft.status ?? "draft");
+      const scheduled = formatScheduledAt(draft, tz);
+      const hint = scheduled ? `${status} \xB7 ${scheduled} ${tz_label}` : status;
+      return {
+        value: String(draft.id),
+        label: `${preview}
+`,
+        hint
+      };
+    })
+  });
+  if (p3.isCancel(draftChoice)) {
+    p3.cancel("Cancelled.");
+    process.exit(0);
+  }
+  const scheduleType = await p3.select({
+    message: "When to publish?",
+    initialValue: "next-free-slot",
+    options: [
+      { value: "next-free-slot", label: "Next free slot" },
+      { value: "custom", label: `Custom date & time  ${pc10.dim(`(${tz_label})`)}` }
+    ]
+  });
+  if (p3.isCancel(scheduleType)) {
+    p3.cancel("Cancelled.");
+    process.exit(0);
+  }
+  let publishAt;
+  if (scheduleType === "next-free-slot") {
+    publishAt = "next-free-slot";
+  } else {
+    const today = todayInTimezone(tz);
+    const dateInput = await p3.text({
+      message: `Date  ${pc10.dim(`(${tz_label}, YYYY-MM-DD)`)}`,
+      placeholder: today,
+      initialValue: today,
+      validate: (v = "") => {
+        if (!v.trim()) return "Date is required";
+        if (!/^\d{4}-\d{2}-\d{2}$/.test(v.trim())) return "Use YYYY-MM-DD format";
+        if (Number.isNaN(Date.parse(v.trim()))) return "Invalid date";
+      }
+    });
+    if (p3.isCancel(dateInput)) {
+      p3.cancel("Cancelled.");
+      process.exit(0);
+    }
+    const timeInput = await p3.text({
+      message: `Time  ${pc10.dim(`(${tz_label}, HH:MM 24h)`)}`,
+      placeholder: "09:00",
+      initialValue: "09:00",
+      validate: (v = "") => {
+        if (!v.trim()) return "Time is required";
+        if (!/^\d{2}:\d{2}$/.test(v.trim())) return "Use HH:MM format";
+        const [h, m] = v.trim().split(":").map(Number);
+        if (h > 23 || m > 59) return "Invalid time";
+      }
+    });
+    if (p3.isCancel(timeInput)) {
+      p3.cancel("Cancelled.");
+      process.exit(0);
+    }
+    publishAt = toUTCIso(dateInput.trim(), timeInput.trim(), tz);
+  }
+  const confirmMsg = scheduleType === "next-free-slot" ? "Schedule to next free slot?" : `Schedule for ${new Date(publishAt).toLocaleString("en-US", { timeZone: tz, month: "short", day: "numeric", year: "numeric", hour: "numeric", minute: "2-digit", hour12: true })} ${tz_label}?`;
+  const confirmed = await p3.confirm({
+    message: confirmMsg,
+    initialValue: true
+  });
+  if (p3.isCancel(confirmed) || !confirmed) {
+    p3.cancel("Cancelled.");
+    process.exit(0);
+  }
+  const s = p3.spinner();
+  s.start("Scheduling\u2026");
+  const result = await apiRequest(
+    "PATCH",
+    `/social-sets/${id}/drafts/${draftChoice}`,
+    { publish_at: publishAt }
+  );
+  s.stop("");
+  display(result, () => renderDraft(result, "Draft scheduled"));
+  const draftUrl = String(result.share_url ?? `https://typefully.com/?d=${draftChoice}`);
+  const openBrowser = await p3.confirm({
+    message: "Open in browser?",
+    initialValue: true
+  });
+  if (!p3.isCancel(openBrowser) && openBrowser) {
+    const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+    exec(`${cmd} "${draftUrl}"`);
+  }
+}
+function registerScheduleCommand(program2) {
+  program2.command("schedule").description("Interactively browse drafts and schedule one").action(async () => {
+    await runScheduler();
+  });
+}
+
+// src/commands/tags.ts
+import pc11 from "picocolors";
 function renderTagsList(data) {
   const results = data.results ?? [];
   if (results.length === 0) {
-    console.log(pc10.yellow("\n  No tags found.\n"));
+    console.log(pc11.yellow("\n  No tags found.\n"));
     return;
   }
   console.log("");
-  console.log(pc10.dim(`  ${results.length} tag${results.length !== 1 ? "s" : ""}`));
+  console.log(pc11.dim(`  ${results.length} tag${results.length !== 1 ? "s" : ""}`));
   console.log("");
   for (let i = 0; i < results.length; i++) {
     const tag = results[i];
-    const num = pc10.dim(`${String(i + 1)}.`.padStart(3));
-    const name = pc10.bold(String(tag.name ?? ""));
-    const slug = tag.slug ? pc10.dim(` (${tag.slug})`) : "";
+    const num = pc11.dim(`${String(i + 1)}.`.padStart(3));
+    const name = pc11.bold(String(tag.name ?? ""));
+    const slug = tag.slug ? pc11.dim(` (${tag.slug})`) : "";
     console.log(`  ${num} ${name}${slug}`);
   }
   console.log("");
@@ -1612,37 +1886,37 @@ function registerTagsCommand(program2) {
   const cmd = program2.command("tags").description("Manage tags");
   cmd.command("list").description("List all tags").argument("[social_set_id]", "Social set ID (uses default if omitted)").action(async (socialSetId) => {
     const id = requireSocialSetId(socialSetId ?? null);
-    const spinner3 = spin("Fetching tags\u2026");
-    spinner3.start();
+    const spinner4 = spin("Fetching tags\u2026");
+    spinner4.start();
     const data = await apiRequest("GET", `/social-sets/${id}/tags?limit=50`);
-    spinner3.stop();
+    spinner4.stop();
     display(data, () => renderTagsList(data));
   });
   cmd.command("create").description("Create a new tag").argument("[social_set_id]", "Social set ID (uses default if omitted)").option("--name <name>", "Tag name (required)").action(async (socialSetId, opts) => {
     const id = requireSocialSetId(socialSetId ?? null);
     if (!opts.name) exitWithError("--name is required");
-    const spinner3 = spin("Creating tag\u2026");
-    spinner3.start();
+    const spinner4 = spin("Creating tag\u2026");
+    spinner4.start();
     const data = await apiRequest("POST", `/social-sets/${id}/tags`, { name: opts.name });
-    spinner3.stop();
+    spinner4.stop();
     display(data, () => {
       const tag = data;
       console.log("");
-      console.log(`  ${pc10.green("\u2713")} Tag created: ${pc10.bold(String(tag.name ?? opts.name))}`);
-      if (tag.slug) console.log(pc10.dim(`  Slug: ${tag.slug}`));
+      console.log(`  ${pc11.green("\u2713")} Tag created: ${pc11.bold(String(tag.name ?? opts.name))}`);
+      if (tag.slug) console.log(pc11.dim(`  Slug: ${tag.slug}`));
       console.log("");
     });
   });
 }
 
 // src/utils/banner.ts
-import pc11 from "picocolors";
+import pc12 from "picocolors";
 var BANNER = `
 \u281B\u28FF\u281B \u28FF\u28E4\u28FF \u28FF\u281B\u28FF \u28FF\u281B\u281B \u28FF\u281B\u281B \u28FF \u28FF \u28FF   \u28FF   \u28FF\u28E4\u28FF
  \u28FF   \u28FF  \u28FF\u281B\u281B \u28FF\u28FF\u28E4 \u28FF\u281B  \u28FF\u28E4\u28FF \u28FF\u28E4\u28E4 \u28FF\u28E4\u28E4  \u28FF
 `;
 function showBanner() {
-  console.error(pc11.dim(BANNER));
+  console.error(pc12.dim(BANNER));
 }
 
 // src/cli.ts
@@ -1650,8 +1924,8 @@ var require2 = createRequire(import.meta.url);
 var pkg = require2("../package.json");
 function createCli() {
   const program2 = new Command();
-  program2.name("typefully").description("Manage social media posts via the Typefully API").version(pkg.version, "-v, --version").option("-j, --json", "Output raw JSON instead of human-readable text").argument("[text]", "Post text \u2014 creates a draft directly, or omit for interactive mode").action(async (text5) => {
-    await runDraft(text5);
+  program2.name("typefully").description("Manage social media posts via the Typefully API").version(pkg.version, "-v, --version").option("-j, --json", "Output raw JSON instead of human-readable text").argument("[text]", "Post text \u2014 creates a draft directly, or omit for interactive mode").action(async (text6) => {
+    await runDraft(text6);
   }).hook("preAction", (_thisCommand) => {
     const jsonMode = !!program2.opts().json;
     setJsonMode(jsonMode);
@@ -1668,6 +1942,7 @@ function createCli() {
   registerTagsCommand(program2);
   registerMediaCommand(program2);
   registerConfigCommand(program2);
+  registerScheduleCommand(program2);
   return program2;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "typefully",
-	"version": "0.2.0",
+	"version": "0.3.0",
 	"type": "module",
 	"bin": {
 		"typefully": "./dist/index.js",

package/skills/spec.md

@@ -3,7 +3,7 @@
 > **This document is the authoritative contract for the Typefully CLI.**
 > All commands, options, arguments, output shapes, and behaviors described here must be satisfied by any conforming implementation.
 
-Last updated: 2026-02-18
+Last updated: 2026-02-19
 
 ---
 
@@ -35,6 +35,8 @@ Last updated: 2026-02-18
    - [config show](#config-show)
    - [config set-default](#config-set-default)
    - [config set-platforms](#config-set-platforms)
+   - [config set-timezone](#config-set-timezone)
+   - [schedule](#schedule)
    - [rm (alias)](#rm-alias)
    - [Default command (tfly)](#default-command-tfly)
 7. [Thread Syntax](#thread-syntax)
@@ -96,7 +98,8 @@ The banner is shown once per invocation before the first command action, **unles
 {
   "apiKey": "typ_xxxx",
   "defaultSocialSetId": 12345,
-  "defaultPlatforms": ["x", "linkedin"]
+  "defaultPlatforms": ["x", "linkedin"],
+  "defaultTimezone": "America/Los_Angeles"
 }
 ```
 
@@ -787,6 +790,92 @@ tfly config set-platforms [options]
 
 ---
 
+### `config set-timezone`
+
+Sets the default timezone used when entering custom schedule times.
+
+```
+typefully config set-timezone [options]
+tfly config set-timezone [options]
+```
+
+**Options**
+
+| Flag | Description |
+|------|-------------|
+| `--timezone <tz>` | IANA timezone name (skips interactive). |
+| `--location <global\|local>` | Where to save: `global` or `local`. Interactive if omitted. |
+| `--scope <global\|local>` | Alias for `--location`. |
+
+**Behavior**
+
+- If `--timezone` is omitted: shows a clack `select` with 14 common IANA timezones plus a "Custom" option that prompts for free-text input.
+- The entered value is validated via `Intl.DateTimeFormat` before saving.
+- Default when not configured: `America/Los_Angeles` (PST/PDT).
+- Stored as `defaultTimezone` in the config JSON.
+
+**JSON output shape**
+
+```json
+{
+  "success": true,
+  "default_timezone": "America/Los_Angeles",
+  "config_path": "/Users/you/.config/typefully/config.json"
+}
+```
+
+---
+
+### `schedule`
+
+Interactively browse drafts and schedule one. Optimised for keyboard-only use.
+
+```
+tfly schedule
+typefully schedule
+```
+
+**No arguments or options.**
+
+**Behavior**
+
+1. Fetches up to 50 drafts (status `draft` or `scheduled`) for the default social set.
+2. Fetches each draft's full details in parallel to load post text.
+3. clack `select` — pick a draft. Each option shows the post preview and current status / scheduled time.
+4. clack `select` — choose when to publish, with **Next free slot** pre-selected:
+   - `Next free slot` — sends `publish_at: "next-free-slot"` to the API.
+   - `Custom date & time` — prompts for date (`YYYY-MM-DD`) and time (`HH:MM`, 24h) in the configured timezone, then converts to UTC ISO 8601 before sending.
+5. clack `confirm` — confirm the schedule (defaults to yes).
+6. Calls `PATCH /social-sets/:id/drafts/:draft_id` with `{ publish_at }`.
+7. Displays the updated draft.
+8. clack `confirm` — **Open in browser?** (defaults to yes). Opens `share_url` or `https://typefully.com/?d=<id>` using the platform-native open command.
+
+**Happy path (keyboard flow)**
+
+```
+↑↓ Enter   — pick draft
+Enter      — confirm "Next free slot" (pre-selected)
+Enter      — confirm schedule
+Enter      — open in browser
+```
+
+**Custom time flow** (breaks the enter-only path intentionally)
+
+```
+↑↓ Enter   — pick draft
+↓ Enter    — select "Custom date & time"
+<date> Enter
+<time> Enter
+Enter      — confirm schedule
+Enter      — open in browser
+```
+
+Cancelling at any prompt (Ctrl+C or selecting No on confirm) exits cleanly with code 0.
+
+**JSON output shape** — single draft object (same as `drafts schedule`).
+
+---
+
 ### `rm` (alias)
 
 Deletes a draft. Provide a draft ID for direct deletion, or omit it for an interactive clack multiselect picker.