$ show supreme-gg-gg/instagram-cli
This is a monorepo housing two terminal-based Instagram clients: a modern TypeScript client using React Ink for a rich Terminal User Interface (TUI) and a legacy Python client using curses. The system provides a full-featured Instagram experience entirely within the terminal, including real-time messaging via MQTT, feed and story browsing, profile viewing, multi-account management, authentication (with 2FA/challenge support), and one-turn CLI commands for AI agent integration. It also incorporates LLM-based chat summarization (OpenAI compatible) and basic analytics in the Python client. Architecture is straightforward: a CLI entry point (Pastel for TS, Typer for Python) dispatches commands, with the TUI built from reusable Ink components (ScrollView, MessageList, InputBox, etc.) that manage state via React hooks and contexts. A mock system enables offline UI development. External dependencies include reverse-engineered Instagram APIs (instagram-private-api, instagram_mqtt) and multiple utility libraries. The dual-client structure and reliance on patched, unofficial APIs introduce maintenance risks, but the TypeScript client is well-crafted with clear separation of concerns, thorough component reuse, and thoughtful UX design for keyboard-driven terminal use.
The LLM identified 4 files worth highlighting for reuse:
A custom Ink component that wraps children in a scrollable view with both keyboard and mouse scroll support. It exposes an imperative ref API (scrollTo, scrollBy, isScrolledToBottom) and handles hit-testing for child clicks by offsetting coordinates. Shows advanced terminal rendering techniques and is reusable in any Ink-based TUI.
Parses ANSI mouse escape sequences (SGR/X11) into structured mouse events (press, release, move, scroll) with terminal screen coordinates. Handles terminal-specific nuances like drag events and mode control. Self-contained and adaptable to any terminal application that needs mouse input.
Unifies Instagram's diverse message item types (text, media, share, action_log, etc.) into a consistent Message interface with a parsed_media field. Handles both direct API responses and realtime MQTT events, validating structure and flattening multimedia attachments. Demonstrates robust type narrowing and can be extracted to any project ingesting social media messages.
Generates plausible mock Instagram data (threads, messages, users, stories, feed) using deterministic timestamps and randomized content. Provides factory functions for UI development and testing without real API calls. Tightly coupled to the application's data structures but the factory pattern is reusable for any social media mock system.