feat: add show command with short-index cache

Persist last displayed tweet lists and allow opening a tweet by index.

- Add twitter_cli/cache.py: stores a short-index cache (~/.twitter-cli/last_results.json) with a 1h TTL and helpers to resolve index->tweet-id and cache size.
- Update twitter_cli/cli.py: save list results to cache, display a hint, and add `twitter show <N>` command which fetches a tweet by cached index and prints detail/replies (supports --full-text, --json, structured output, and max replies).
- Update README.md and SKILL.md to document the new `show` usage.
- Add .idea/ to .gitignore and bump package version in uv.lock to 0.8.0.

This change makes it easy to open items from the last feed/search without copying IDs.

.gitignore

@@ -8,3 +8,4 @@ build/
 *.json
 !tests/fixtures/*.json
 !config.yaml
+.idea/

README.md

@@ -23,7 +23,7 @@ A terminal-first CLI for Twitter/X: read timelines, bookmarks, and user profiles
 - Timeline: fetch `for-you` and `following` feeds
 - Bookmarks: list saved tweets from your account
 - Search: find tweets by keyword with Top/Latest/Photos/Videos tabs
-- Tweet detail: view a tweet and its replies
+- Tweet detail: view a tweet and its replies; use `show <N>` to open tweet #N from the last list output
 - Article: fetch a Twitter Article and export it as Markdown
 - List timeline: fetch tweets from a Twitter List
 - User lookup: fetch user profile, tweets, likes, followers, and following
@@ -122,6 +122,11 @@ twitter tweet 1234567890
 twitter tweet 1234567890 --full-text
 twitter tweet https://x.com/user/status/1234567890
 
+# Open tweet by index from last list output
+twitter show 2                         # Open tweet #2 from last feed/search
+twitter show 2 --full-text             # Full text in reply table
+twitter show 2 --json                  # Structured output
+
 # Twitter Article
 twitter article 1234567890
 twitter article https://x.com/user/article/1234567890 --json
@@ -358,7 +363,7 @@ After installation, OpenClaw can call `twitter-cli` commands directly.
 - 时间线读取：支持 `for-you` 和 `following`
 - 收藏读取：查看账号书签推文
 - 搜索：按关键词搜索推文，支持 Top/Latest/Photos/Videos
-- 推文详情：查看推文及其回复
+- 推文详情：查看推文及其回复；用 `show <N>` 可直接打开上次列表里的第 N 条推文
 - 文章读取：获取 Twitter 长文，并导出为 Markdown
 - 列表时间线：获取 Twitter List 的推文
 - 用户查询：查看用户资料、推文、点赞、粉丝和关注
@@ -425,6 +430,11 @@ twitter search "trending" --filter              # 启用排序筛选
 twitter tweet 1234567890
 twitter tweet 1234567890 --full-text
 
+# 通过序号打开上次列表里的推文
+twitter show 2                         # 打开上次 feed/search 的第 2 条
+twitter show 2 --full-text             # 在回复表格里显示完整正文
+twitter show 2 --json                  # 结构化输出
+
 # Twitter 长文
 twitter article 1234567890
 twitter article https://x.com/user/article/1234567890 --json

SKILL.md

@@ -165,6 +165,9 @@ twitter search "topic" -o results.json # Save to file
 twitter tweet 1234567890               # Tweet detail + replies
 twitter tweet 1234567890 --full-text   # Full text in reply table
 twitter tweet https://x.com/user/status/12345  # Accepts URL
+twitter show 2                         # Open tweet #2 from last feed/search list
+twitter show 2 --full-text             # Full text in reply table
+twitter show 2 --json                  # Structured output
 twitter list 1539453138322673664       # List timeline
 twitter list 1539453138322673664 --full-text
 twitter user-posts elonmusk --max 20   # User's tweets

twitter_cli/cache.py

@@ -0,0 +1,62 @@
+"""Short-index cache: persist the last displayed tweet list for quick `show` access."""
+
+from __future__ import annotations
+
+import json
+import logging
+import time
+from pathlib import Path
+from typing import List, Optional
+
+from .models import Tweet
+
+logger = logging.getLogger(__name__)
+
+_CACHE_DIR = Path.home() / ".twitter-cli"
+_CACHE_FILE = _CACHE_DIR / "last_results.json"
+_TTL = 3600  # seconds
+
+
+def save_tweet_cache(tweets: List[Tweet]) -> None:
+    """Persist tweet list so indices can be resolved by `show`."""
+    try:
+        _CACHE_DIR.mkdir(parents=True, exist_ok=True)
+        entries = [
+            {"index": i + 1, "id": t.id, "author": t.author.screen_name, "text": t.text[:80]}
+            for i, t in enumerate(tweets)
+            if t.id
+        ]
+        payload = {"created_at": time.time(), "tweets": entries}
+        _CACHE_FILE.write_text(json.dumps(payload, ensure_ascii=False, indent=2), encoding="utf-8")
+    except OSError as exc:
+        logger.debug("Failed to write tweet cache: %s", exc)
+
+
+def _load_cache() -> Optional[List[dict]]:
+    """Load and validate the cache file; return tweet entries or None if stale/missing."""
+    try:
+        if not _CACHE_FILE.exists():
+            return None
+        payload = json.loads(_CACHE_FILE.read_text(encoding="utf-8"))
+        if time.time() - payload.get("created_at", 0) > _TTL:
+            return None
+        return payload.get("tweets", [])
+    except (OSError, json.JSONDecodeError):
+        return None
+
+
+def get_tweet_id_by_index(index: int) -> Optional[str]:
+    """Return tweet ID at *index* (1-based), or None if not found."""
+    entries = _load_cache()
+    if entries is None:
+        return None
+    for entry in entries:
+        if entry.get("index") == index:
+            return str(entry["id"])
+    return None
+
+
+def get_cache_size() -> int:
+    """Return number of tweets in the current cache (0 if unavailable)."""
+    entries = _load_cache()
+    return len(entries) if entries is not None else 0

twitter_cli/cli.py

@@ -45,6 +45,7 @@ from rich.console import Console
 
 from . import __version__
 from .auth import get_cookies
+from .cache import get_cache_size, get_tweet_id_by_index, save_tweet_cache
 from .client import TwitterClient
 from .config import load_config
 from .filter import filter_tweets
@@ -351,12 +352,14 @@ def _fetch_and_display(fetch_fn, label, emoji, max_count, as_json, as_yaml, outp
     if emit_structured(tweets_to_data(filtered), as_json=as_json, as_yaml=as_yaml):
         return
 
+    save_tweet_cache(filtered)
     print_tweet_table(
         filtered,
         console,
         title="%s %s — %d tweets" % (emoji, label, len(filtered)),
         full_text=full_text,
     )
+    console.print("[dim]💡 Use `twitter show <N>` to view tweet #N from this list.[/dim]")
     console.print()
 
 
@@ -445,7 +448,9 @@ def feed(ctx, feed_type, max_count, as_json, as_yaml, input_file, output_file, d
 
     title = "👥 Following" if feed_type == "following" else "📱 Twitter"
     title += " — %d tweets" % len(filtered)
+    save_tweet_cache(filtered)
     print_tweet_table(filtered, console, title=title, full_text=full_text)
+    console.print("[dim]💡 Use `twitter show <N>` to view tweet #N from this list.[/dim]")
     console.print()
 
 
@@ -714,6 +719,57 @@ def tweet(ctx, tweet_id, max_count, full_text, as_json, as_yaml):
     console.print()
 
 
+@cli.command()
+@click.argument("index", type=int)
+@click.option("--max", "-n", "max_count", type=int, default=None, help="Max replies to fetch.")
+@click.option("--full-text", is_flag=True, help="Show full reply text in table output.")
+@structured_output_options
+@click.pass_context
+def show(ctx, index, max_count, full_text, as_json, as_yaml):
+    # type: (Any, int, Optional[int], bool, bool, bool) -> None
+    """View tweet #INDEX from the last feed/search results."""
+    compact = ctx.obj.get("compact", False)
+
+    tweet_id = get_tweet_id_by_index(index)
+    if tweet_id is None:
+        cache_size = get_cache_size()
+        if cache_size == 0:
+            raise click.UsageError(
+                "No cached results found. Run `twitter feed` or `twitter search` first."
+            )
+        raise click.UsageError(
+            "Index %d is out of range (cache has %d tweets)." % (index, cache_size)
+        )
+
+    config = load_config()
+    rich_output = use_rich_output(as_json=as_json, as_yaml=as_yaml, compact=compact)
+    try:
+        client = _get_client_for_output(config, quiet=not rich_output)
+        if rich_output:
+            console.print("🐦 Fetching tweet #%d (id: %s)...\n" % (index, tweet_id))
+        start = time.time()
+        tweets = client.fetch_tweet_detail(tweet_id, _resolve_configured_count(config, max_count))
+        elapsed = time.time() - start
+        if rich_output:
+            console.print("✅ Fetched %d tweets in %.1fs\n" % (len(tweets), elapsed))
+    except RuntimeError as exc:
+        _exit_with_error(exc)
+
+    if compact:
+        click.echo(tweets_to_compact_json(tweets))
+        return
+
+    if emit_structured(tweets_to_data(tweets), as_json=as_json, as_yaml=as_yaml):
+        return
+
+    if tweets:
+        print_tweet_detail(tweets[0], console)
+        if len(tweets) > 1:
+            console.print("\n💬 Replies:")
+            print_tweet_table(tweets[1:], console, title="💬 Replies — %d" % (len(tweets) - 1), full_text=full_text)
+    console.print()
+
+
 @cli.command()
 @click.argument("tweet_id")
 @structured_output_options

uv.lock

@@ -609,7 +609,7 @@ wheels = [
 
 [[package]]
 name = "twitter-cli"
-version = "0.7.1"
+version = "0.8.0"
 source = { editable = "." }
 dependencies = [
     { name = "beautifulsoup4" },