@jackwener/opencli 1.7.14 → 1.7.16

package/cli-manifest.json

@@ -2443,7 +2443,7 @@
         "type": "str",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Bilibili 视频 BV ID（如 BV1xx411c7mD），或视频 URL / b23.tv 短链"
       },
       {
         "name": "lang",
@@ -6896,7 +6896,7 @@
         "name": "city",
         "type": "str",
         "required": false,
-        "help": "城市名（北京/上海/beijing/...）或 cityId 数字。不传则使用 cookie 默认城市"
+        "help": "城市名（北京/上海/汕头/beijing/shantou/...）或 cityId 数字。未在静态表中的城市会通过 dianping.com 在线解析。不传则使用 cookie 默认城市"
       },
       {
         "name": "limit",
@@ -8491,7 +8491,7 @@
         "type": "str",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "抖音作品 ID（aweme_id，可从作品 URL 末尾获取）"
       }
     ],
     "columns": [
@@ -8517,7 +8517,7 @@
         "type": "str",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "抖音作品 ID（aweme_id，可从作品 URL 末尾获取）"
       },
       {
         "name": "reschedule",
@@ -13173,7 +13173,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "即刻搜索关键词"
       },
       {
         "name": "limit",
@@ -17181,6 +17181,43 @@
     "modulePath": "openfda/food-recall.js",
     "sourceFile": "openfda/food-recall.js"
   },
+  {
+    "site": "openreview",
+    "name": "author",
+    "description": "List OpenReview submissions by an author profile id (newest first)",
+    "access": "read",
+    "domain": "openreview.net",
+    "strategy": "public",
+    "browser": false,
+    "args": [
+      {
+        "name": "profile",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "OpenReview profile id (e.g. \"~Yoshua_Bengio1\"). Find it on the author profile URL on openreview.net."
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 50,
+        "required": false,
+        "help": "Max submissions (1-1000)"
+      }
+    ],
+    "columns": [
+      "rank",
+      "id",
+      "title",
+      "authors",
+      "venue",
+      "pdate",
+      "url"
+    ],
+    "type": "js",
+    "modulePath": "openreview/author.js",
+    "sourceFile": "openreview/author.js"
+  },
   {
     "site": "openreview",
     "name": "paper",
@@ -19110,7 +19147,10 @@
     "type": "js",
     "modulePath": "reddit/comment.js",
     "sourceFile": "reddit/comment.js",
-    "navigateBefore": "https://reddit.com"
+    "navigateBefore": "https://reddit.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "reddit",
@@ -19140,7 +19180,10 @@
     "type": "js",
     "modulePath": "reddit/frontpage.js",
     "sourceFile": "reddit/frontpage.js",
-    "navigateBefore": "https://reddit.com"
+    "navigateBefore": "https://reddit.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "reddit",
@@ -19209,7 +19252,10 @@
     "type": "js",
     "modulePath": "reddit/popular.js",
     "sourceFile": "reddit/popular.js",
-    "navigateBefore": "https://reddit.com"
+    "navigateBefore": "https://reddit.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "reddit",
@@ -19272,7 +19318,10 @@
     "type": "js",
     "modulePath": "reddit/read.js",
     "sourceFile": "reddit/read.js",
-    "navigateBefore": "https://reddit.com"
+    "navigateBefore": "https://reddit.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "reddit",
@@ -19305,7 +19354,10 @@
     "type": "js",
     "modulePath": "reddit/save.js",
     "sourceFile": "reddit/save.js",
-    "navigateBefore": "https://reddit.com"
+    "navigateBefore": "https://reddit.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "reddit",
@@ -19334,7 +19386,10 @@
     "type": "js",
     "modulePath": "reddit/saved.js",
     "sourceFile": "reddit/saved.js",
-    "navigateBefore": "https://reddit.com"
+    "navigateBefore": "https://reddit.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "reddit",
@@ -19350,7 +19405,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Reddit search query"
       },
       {
         "name": "subreddit",
@@ -19392,7 +19447,10 @@
     "type": "js",
     "modulePath": "reddit/search.js",
     "sourceFile": "reddit/search.js",
-    "navigateBefore": "https://reddit.com"
+    "navigateBefore": "https://reddit.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "reddit",
@@ -19408,7 +19466,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Subreddit name (no `r/` prefix; e.g. `python`)"
       },
       {
         "name": "sort",
@@ -19442,7 +19500,10 @@
     "type": "js",
     "modulePath": "reddit/subreddit.js",
     "sourceFile": "reddit/subreddit.js",
-    "navigateBefore": "https://reddit.com"
+    "navigateBefore": "https://reddit.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "reddit",
@@ -19475,7 +19536,10 @@
     "type": "js",
     "modulePath": "reddit/subscribe.js",
     "sourceFile": "reddit/subscribe.js",
-    "navigateBefore": "https://reddit.com"
+    "navigateBefore": "https://reddit.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "reddit",
@@ -19508,7 +19572,10 @@
     "type": "js",
     "modulePath": "reddit/upvote.js",
     "sourceFile": "reddit/upvote.js",
-    "navigateBefore": "https://reddit.com"
+    "navigateBefore": "https://reddit.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "reddit",
@@ -19537,7 +19604,10 @@
     "type": "js",
     "modulePath": "reddit/upvoted.js",
     "sourceFile": "reddit/upvoted.js",
-    "navigateBefore": "https://reddit.com"
+    "navigateBefore": "https://reddit.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "reddit",
@@ -19553,7 +19623,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Reddit username (no `u/` prefix needed)"
       }
     ],
     "columns": [
@@ -19563,7 +19633,10 @@
     "type": "js",
     "modulePath": "reddit/user.js",
     "sourceFile": "reddit/user.js",
-    "navigateBefore": "https://reddit.com"
+    "navigateBefore": "https://reddit.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "reddit",
@@ -19579,7 +19652,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Reddit username (no `u/` prefix needed)"
       },
       {
         "name": "limit",
@@ -19598,7 +19671,10 @@
     "type": "js",
     "modulePath": "reddit/user-comments.js",
     "sourceFile": "reddit/user-comments.js",
-    "navigateBefore": "https://reddit.com"
+    "navigateBefore": "https://reddit.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "reddit",
@@ -19614,7 +19690,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Reddit username (no `u/` prefix needed)"
       },
       {
         "name": "limit",
@@ -19634,7 +19710,10 @@
     "type": "js",
     "modulePath": "reddit/user-posts.js",
     "sourceFile": "reddit/user-posts.js",
-    "navigateBefore": "https://reddit.com"
+    "navigateBefore": "https://reddit.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "rest-countries",
@@ -22175,7 +22254,10 @@
     "type": "js",
     "modulePath": "twitter/article.js",
     "sourceFile": "twitter/article.js",
-    "navigateBefore": "https://x.com"
+    "navigateBefore": "https://x.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "twitter",
@@ -22229,10 +22311,82 @@
     "sourceFile": "twitter/bookmark.js",
     "navigateBefore": true
   },
+  {
+    "site": "twitter",
+    "name": "bookmark-folder",
+    "description": "Read the tweets inside a single Twitter/X bookmark folder. Get the folder id from `opencli twitter bookmark-folders`.",
+    "access": "read",
+    "domain": "x.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "folder-id",
+        "type": "string",
+        "required": true,
+        "positional": true,
+        "help": "Folder id from `opencli twitter bookmark-folders`."
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "help": "Maximum number of bookmarks to return (default 20)."
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the folder by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps the API's native (saved-time) ordering."
+      }
+    ],
+    "columns": [
+      "id",
+      "author",
+      "text",
+      "likes",
+      "retweets",
+      "bookmarks",
+      "created_at",
+      "url"
+    ],
+    "type": "js",
+    "modulePath": "twitter/bookmark-folder.js",
+    "sourceFile": "twitter/bookmark-folder.js",
+    "navigateBefore": "https://x.com",
+    "browserSession": {
+      "reuse": "site"
+    }
+  },
+  {
+    "site": "twitter",
+    "name": "bookmark-folders",
+    "description": "List your Twitter/X bookmark folders (the user-created collections under Bookmarks). Returns folder id, name, item count, and created_at.",
+    "access": "read",
+    "domain": "x.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [],
+    "columns": [
+      "id",
+      "name",
+      "items",
+      "created_at"
+    ],
+    "type": "js",
+    "modulePath": "twitter/bookmark-folders.js",
+    "sourceFile": "twitter/bookmark-folders.js",
+    "navigateBefore": "https://x.com",
+    "browserSession": {
+      "reuse": "site"
+    }
+  },
   {
     "site": "twitter",
     "name": "bookmarks",
-    "description": "Fetch Twitter/X bookmarks",
+    "description": "Fetch your Twitter/X bookmarks (the logged-in user's saved tweets, newest first)",
     "access": "read",
     "domain": "x.com",
     "strategy": "cookie",
@@ -22243,7 +22397,14 @@
         "type": "int",
         "default": 20,
         "required": false,
-        "help": ""
+        "help": "Maximum number of bookmarks to return (default 20)."
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the bookmarks by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps the API's native (saved-time) ordering."
       }
     ],
     "columns": [
@@ -22259,7 +22420,10 @@
     "type": "js",
     "modulePath": "twitter/bookmarks.js",
     "sourceFile": "twitter/bookmarks.js",
-    "navigateBefore": "https://x.com"
+    "navigateBefore": "https://x.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "twitter",
@@ -22290,7 +22454,7 @@
   {
     "site": "twitter",
     "name": "download",
-    "description": "下载 Twitter/X 媒体（图片和视频）",
+    "description": "Download Twitter/X media (images and videos). Provide either <username> to scan a profile's media tab, or --tweet-url to download a single tweet.",
     "access": "read",
     "domain": "x.com",
     "strategy": "cookie",
@@ -22301,27 +22465,27 @@
         "type": "str",
         "required": false,
         "positional": true,
-        "help": "Twitter username (downloads from media tab)"
+        "help": "Twitter username (with or without @) to scan their /media tab. Either <username> or --tweet-url is required."
       },
       {
         "name": "tweet-url",
         "type": "str",
         "required": false,
-        "help": "Single tweet URL to download"
+        "help": "Single tweet URL to download. Use this OR <username>, not both required at once."
       },
       {
         "name": "limit",
         "type": "int",
         "default": 10,
         "required": false,
-        "help": "Number of tweets to scan"
+        "help": "Maximum number of media items to download when scanning a profile (default 10). Ignored when --tweet-url is used."
       },
       {
         "name": "output",
         "type": "str",
         "default": "./twitter-downloads",
         "required": false,
-        "help": "Output directory"
+        "help": "Output directory (default ./twitter-downloads). A per-source subdir is created inside."
       }
     ],
     "columns": [
@@ -22333,7 +22497,10 @@
     "type": "js",
     "modulePath": "twitter/download.js",
     "sourceFile": "twitter/download.js",
-    "navigateBefore": "https://x.com"
+    "navigateBefore": "https://x.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "twitter",
@@ -22364,7 +22531,7 @@
   {
     "site": "twitter",
     "name": "followers",
-    "description": "Get accounts following a Twitter/X user",
+    "description": "Get accounts following a Twitter/X user (defaults to the logged-in user when no user is given)",
     "access": "read",
     "domain": "x.com",
     "strategy": "ui",
@@ -22375,14 +22542,14 @@
         "type": "string",
         "required": false,
         "positional": true,
-        "help": ""
+        "help": "Twitter/X handle (with or without @). Omit to fetch followers of the currently logged-in account."
       },
       {
         "name": "limit",
         "type": "int",
         "default": 50,
         "required": false,
-        "help": ""
+        "help": "Maximum number of follower rows to return (default 50). Must be a positive integer."
       }
     ],
     "columns": [
@@ -22393,12 +22560,15 @@
     "type": "js",
     "modulePath": "twitter/followers.js",
     "sourceFile": "twitter/followers.js",
-    "navigateBefore": true
+    "navigateBefore": true,
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "twitter",
     "name": "following",
-    "description": "Get accounts a Twitter/X user is following",
+    "description": "Get accounts a Twitter/X user is following (defaults to the logged-in user when no user is given)",
     "access": "read",
     "domain": "x.com",
     "strategy": "cookie",
@@ -22409,14 +22579,14 @@
         "type": "string",
         "required": false,
         "positional": true,
-        "help": ""
+        "help": "Twitter/X handle (with or without @). Omit to fetch the accounts the currently logged-in user follows."
       },
       {
         "name": "limit",
         "type": "int",
         "default": 50,
         "required": false,
-        "help": ""
+        "help": "Maximum number of following rows to return (default 50). Must be a positive integer."
       }
     ],
     "columns": [
@@ -22428,7 +22598,10 @@
     "type": "js",
     "modulePath": "twitter/following.js",
     "sourceFile": "twitter/following.js",
-    "navigateBefore": "https://x.com"
+    "navigateBefore": "https://x.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "twitter",
@@ -22485,7 +22658,7 @@
   {
     "site": "twitter",
     "name": "likes",
-    "description": "Fetch liked tweets of a Twitter user",
+    "description": "Fetch liked tweets of a Twitter user (defaults to the logged-in user when no username is given)",
     "access": "read",
     "domain": "x.com",
     "strategy": "cookie",
@@ -22496,14 +22669,21 @@
         "type": "string",
         "required": false,
         "positional": true,
-        "help": "Twitter screen name (without @). Defaults to logged-in user."
+        "help": "Twitter screen name (with or without @). Defaults to the logged-in user when omitted."
       },
       {
         "name": "limit",
         "type": "int",
         "default": 20,
         "required": false,
-        "help": ""
+        "help": "Maximum number of liked tweets to return (default 20)."
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the liked tweets by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps the API's native (recency) ordering."
       }
     ],
     "columns": [
@@ -22521,7 +22701,10 @@
     "type": "js",
     "modulePath": "twitter/likes.js",
     "sourceFile": "twitter/likes.js",
-    "navigateBefore": "https://x.com"
+    "navigateBefore": "https://x.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "twitter",
@@ -22537,14 +22720,14 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Numeric ID of the list you own (e.g. from `opencli twitter lists`)"
       },
       {
         "name": "username",
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Twitter/X handle to add (with or without @)"
       }
     ],
     "columns": [
@@ -22573,14 +22756,14 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Numeric ID of the list you own (e.g. from `opencli twitter lists`)"
       },
       {
         "name": "username",
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Twitter/X handle to remove (with or without @)"
       }
     ],
     "columns": [
@@ -22609,7 +22792,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Numeric ID of a Twitter/X list (e.g. from `opencli twitter lists`)"
       },
       {
         "name": "limit",
@@ -22617,6 +22800,13 @@
         "default": 50,
         "required": false,
         "help": ""
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the list timeline by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps the list's native (recency) ordering."
       }
     ],
     "columns": [
@@ -22632,7 +22822,10 @@
     "type": "js",
     "modulePath": "twitter/list-tweets.js",
     "sourceFile": "twitter/list-tweets.js",
-    "navigateBefore": "https://x.com"
+    "navigateBefore": "https://x.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "twitter",
@@ -22648,7 +22841,7 @@
         "type": "int",
         "default": 50,
         "required": false,
-        "help": ""
+        "help": "Maximum number of lists to return (default 50)."
       }
     ],
     "columns": [
@@ -22661,12 +22854,15 @@
     "type": "js",
     "modulePath": "twitter/lists.js",
     "sourceFile": "twitter/lists.js",
-    "navigateBefore": "https://x.com"
+    "navigateBefore": "https://x.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "twitter",
     "name": "notifications",
-    "description": "Get Twitter/X notifications",
+    "description": "Get your Twitter/X notifications (the logged-in user's likes/replies/follows feed, newest first)",
     "access": "read",
     "domain": "x.com",
     "strategy": "intercept",
@@ -22677,7 +22873,7 @@
         "type": "int",
         "default": 20,
         "required": false,
-        "help": ""
+        "help": "Maximum number of notifications to return (default 20)."
       }
     ],
     "columns": [
@@ -22690,7 +22886,10 @@
     "type": "js",
     "modulePath": "twitter/notifications.js",
     "sourceFile": "twitter/notifications.js",
-    "navigateBefore": true
+    "navigateBefore": true,
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "twitter",
@@ -22728,7 +22927,7 @@
   {
     "site": "twitter",
     "name": "profile",
-    "description": "Fetch a Twitter user profile (bio, stats, etc.)",
+    "description": "Fetch a Twitter user profile — bio, stats, etc. (defaults to the logged-in user when no username is given)",
     "access": "read",
     "domain": "x.com",
     "strategy": "cookie",
@@ -22739,7 +22938,7 @@
         "type": "string",
         "required": false,
         "positional": true,
-        "help": "Twitter screen name (without @). Defaults to logged-in user."
+        "help": "Twitter screen name (with or without @). Defaults to the logged-in user when omitted."
       }
     ],
     "columns": [
@@ -22758,12 +22957,15 @@
     "type": "js",
     "modulePath": "twitter/profile.js",
     "sourceFile": "twitter/profile.js",
-    "navigateBefore": "https://x.com"
+    "navigateBefore": "https://x.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "twitter",
     "name": "quote",
-    "description": "Quote-tweet a specific tweet with your own text",
+    "description": "Quote-tweet a specific tweet with your own text, optionally with a local or remote image",
     "access": "write",
     "domain": "x.com",
     "strategy": "ui",
@@ -22782,6 +22984,18 @@
         "required": true,
         "positional": true,
         "help": "The text content of your quote"
+      },
+      {
+        "name": "image",
+        "type": "str",
+        "required": false,
+        "help": "Optional local image path to attach to the quote tweet"
+      },
+      {
+        "name": "image-url",
+        "type": "str",
+        "required": false,
+        "help": "Optional remote image URL to download and attach to the quote tweet"
       }
     ],
     "columns": [
@@ -22918,7 +23132,7 @@
   {
     "site": "twitter",
     "name": "search",
-    "description": "Search Twitter/X for tweets",
+    "description": "Search Twitter/X for tweets, with optional --from / --has / --exclude / --product filters mapped to X's search operators",
     "access": "read",
     "domain": "x.com",
     "strategy": "intercept",
@@ -22929,25 +23143,75 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Search query. Raw X operators (e.g. \"exact phrase\", #tag, OR, lang:en, since:YYYY-MM-DD, from:, since:) are passed through unchanged."
       },
       {
         "name": "filter",
         "type": "string",
         "default": "top",
         "required": false,
-        "help": "",
+        "help": "Legacy alias for --product. Kept for backwards compatibility; if --product is set it wins.",
         "choices": [
           "top",
           "live"
         ]
       },
+      {
+        "name": "product",
+        "type": "string",
+        "required": false,
+        "help": "Which X search tab to read: top (default), live (Latest), photos, videos. Maps to the f= URL param.",
+        "choices": [
+          "top",
+          "live",
+          "photos",
+          "videos"
+        ]
+      },
+      {
+        "name": "from",
+        "type": "string",
+        "required": false,
+        "help": "Restrict to tweets authored by <user>. Leading @ is stripped. Equivalent to appending `from:<user>` to the query."
+      },
+      {
+        "name": "has",
+        "type": "string",
+        "required": false,
+        "help": "Restrict to tweets that have media|images|videos|links|replies. Maps to X's `filter:<has>` operator.",
+        "choices": [
+          "media",
+          "images",
+          "videos",
+          "links",
+          "replies"
+        ]
+      },
+      {
+        "name": "exclude",
+        "type": "string",
+        "required": false,
+        "help": "Exclude tweets matching <type>: replies|retweets|media|links. Maps to X's `-filter:<x>` operator (retweets → -filter:nativeretweets).",
+        "choices": [
+          "replies",
+          "retweets",
+          "media",
+          "links"
+        ]
+      },
       {
         "name": "limit",
         "type": "int",
         "default": 15,
         "required": false,
-        "help": ""
+        "help": "Maximum number of tweets to return (default 15). Result count after server-side filtering."
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the results by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps X's native ordering."
       }
     ],
     "columns": [
@@ -22964,7 +23228,10 @@
     "type": "js",
     "modulePath": "twitter/search.js",
     "sourceFile": "twitter/search.js",
-    "navigateBefore": true
+    "navigateBefore": true,
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "twitter",
@@ -22980,7 +23247,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Tweet numeric ID (e.g. 1234567890) or full status URL"
       },
       {
         "name": "limit",
@@ -22988,6 +23255,13 @@
         "default": 50,
         "required": false,
         "help": ""
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the thread by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps the conversation's structural ordering."
       }
     ],
     "columns": [
@@ -23003,12 +23277,15 @@
     "type": "js",
     "modulePath": "twitter/thread.js",
     "sourceFile": "twitter/thread.js",
-    "navigateBefore": "https://x.com"
+    "navigateBefore": "https://x.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "twitter",
     "name": "timeline",
-    "description": "Fetch Twitter timeline (for-you or following)",
+    "description": "Fetch the logged-in user's home timeline (for-you algorithmic feed by default; pass --type following for the chronological feed of accounts you follow)",
     "access": "read",
     "domain": "x.com",
     "strategy": "cookie",
@@ -23019,7 +23296,7 @@
         "type": "str",
         "default": "for-you",
         "required": false,
-        "help": "Timeline type: for-you (algorithmic) or following (chronological)",
+        "help": "Which home-timeline feed to read. Default for-you (algorithmic). Use following for the chronological feed of accounts you follow.",
         "choices": [
           "for-you",
           "following"
@@ -23030,7 +23307,14 @@
         "type": "int",
         "default": 20,
         "required": false,
-        "help": ""
+        "help": "Maximum number of tweets to return (default 20)."
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the timeline by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps X's native ordering."
       }
     ],
     "columns": [
@@ -23049,7 +23333,10 @@
     "type": "js",
     "modulePath": "twitter/timeline.js",
     "sourceFile": "twitter/timeline.js",
-    "navigateBefore": "https://x.com"
+    "navigateBefore": "https://x.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "twitter",
@@ -23076,7 +23363,10 @@
     "type": "js",
     "modulePath": "twitter/trending.js",
     "sourceFile": "twitter/trending.js",
-    "navigateBefore": "https://x.com"
+    "navigateBefore": "https://x.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "twitter",
@@ -23100,6 +23390,13 @@
         "default": 20,
         "required": false,
         "help": "Max tweets to return"
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the tweets by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps the chronological ordering."
       }
     ],
     "columns": [
@@ -23119,7 +23416,10 @@
     "type": "js",
     "modulePath": "twitter/tweets.js",
     "sourceFile": "twitter/tweets.js",
-    "navigateBefore": "https://x.com"
+    "navigateBefore": "https://x.com",
+    "browserSession": {
+      "reuse": "site"
+    }
   },
   {
     "site": "twitter",