Instagram CLI — Agent Usage Guide

Instagram CLI (instagram-cli) is a terminal client for Instagram. For agents, it exposes one-turn commands that print to stdout and exit — perfect for scripting and tool-use.

All one-turn commands require the user to already be logged in (instagram-cli auth login). If a command returns an auth error, prompt the user to log in first. Do not attempt to login using the CLI by yourself.

Thread Resolution

Every command that targets a thread accepts a <thread> argument resolved in this order:

1. Thread ID (20+ digit number like 340282366920938463...) — direct, zero extra API calls
2. Username — exact Instagram username (e.g. johndoe)
3. Thread title — fuzzy search across inbox (e.g. "Book Club")