Agent Instagram

An Instagram DM CLI for AI agents. Supports browser cookie extraction (zero-config, extracts from Chromium browsers) and username/password authentication (with 2FA). Uses Instagram's private mobile API to read and send direct messages.

Use one of these entrypoints:

• Global install: agent-instagram ...
• One-off execution: bunx --package agent-messenger agent-instagram ...

Key Concepts

• Thread ID = Instagram's identifier for a DM conversation. Numeric string returned by chat list.
• Browser cookie extraction = recommended auth method. Extracts cookies from Chromium browsers (Chrome, Chrome Canary, Edge, Arc, Brave, Vivaldi, Chromium) where you're logged into instagram.com. Zero-config.
• Username/password auth = fallback method. Authenticates using Instagram credentials. Supports two-factor authentication via SMS or authenticator app.
• HTTP-based = each command makes HTTP requests and returns. No persistent connection or background process.
• Multi-account = multiple Instagram accounts can be stored. Use auth list and auth use to switch between them.
• DM-only = this CLI focuses on Instagram Direct Messages. It does not manage posts, stories, or followers.

Quick Start