快速判断
- 01这个 Skill 是干嘛的
- 通过命令行和 skill 管理 Instagram 内容发布与常见账号操作。
- 02它能解决什么问题
- 解决社媒操作依赖手工界面、批量处理困难和自动化流程难以复用的问题。
- 03它适合谁来用
- 适合需要程序化管理 Instagram 内容的运营人员和自动化开发者。
预览 · README.md
中文为 README 译文；English 保留 GitHub README 原文。
instagram-cli
通过命令行和技能封装管理 Instagram 内容与常见操作。
主要能力
How to use Instagram CLI to interact with Instagram from the command line on behalf of a user. Use this skill whenever the user wants to send or read Instagram messages, check their inbox, reply to or unsend messages, or automate any Instagram DM workflow via the CLI. This includes tasks phrased as "message X on Instagram", "check my Instagram DMs", "send a photo to my friend", "read my unread Instagram threads", or any automation / scripting involving Instagram direct messages.
使用方式
仓库级安装会保留完整目录；本次核验的入口是 skills/instagram-skill/SKILL.md。使用前先阅读英文 README 与原始 SKILL.md，并按当前 Agent 的目录规范安装。
适用边界
自动化社交平台操作前必须遵守平台条款并避免高频批量行为。
许可与来源
来源：GitHub 公开仓库。核验许可：MIT。本页是贴近原仓库结构的中文导读，具体参数、依赖和更新记录以英文 README 为准。
Instagram CLI
The ultimate weapon against brainrot. The fastest, lightest, and most portable Instagram client.
$$ \text{Instagram}_{\text{CLI}} = \lim_{\text{screen time} \to 0} \text{Productivity} \to \infty $$
https://github.com/user-attachments/assets/ddcc5a2d-15da-4cd6-8747-9e7956b32c0b
[!WARNING] This project is not affiliated with, authorized, or endorsed by Instagram. This is an independent and unofficial project. Using it might violate Meta's Terms of Service. Use at your own risk.
Why Instagram CLI?
Empower yourself to become a 10x Instagrammer by minimizing distractions, enabling 100% keyboard control, and accessing it from any terminal — whether in your VSCode editor or your Linux server.
Instagram CLI allows you to use social media more intentionally -- to stay connected with people you care about rather than being exploited for your attention.
- Chat with your friends without falling into endless brainrot
- Stay updated with post and stories from people around you
- Focus on meaningful, intentional conversations and be productive
- Full keyboard navigation and shortcuts, no mouse, no touchscreens
- Celebrate the art and simplicity of terminal UI (TUI)
Installation
NPM
Requires Node.js v22 or higher.
npm install -g @i7m/instagram-cliHomebrew (macOS/Linux)
brew tap supreme-gg-gg/tap
brew install instagram-cliThe formula is available here.
We also ship a Python client with nostalgic UNIX vibes since Instagram CLI was first built in Python with curses. For installation and more information, see Python Client Documentation.
Community Packages
The following packages are supported by the community. The maintainers of Instagram CLI do not provide support for these packages.
AUR (Arch Linux)
yay -S instagram-cliSnap (Linux)
snapcraft pack
sudo snap install instagram-cli_1.4.0_amd64.snap --dangerous
snap run instagram-cli.instagram-cli
# OR, since /snap/bin is in PATH
instagram-cliWe welcome contributions to add more installation methods.
For installation from source, please refer to the TypeScript Client Documentation.
CLI Commands
The following commands will be available after installing the package:
instagram-cli # display title art
instagram-cli --help # view available commands
# Authentication
instagram-cli auth login --username # login with username and password
instagram-cli auth logout # logout and removes session
instagram-cli auth switch <username> # switch to another saved account
instagram-cli auth whoami # display current default user
# Launches TUI interfaces
instagram-cli chat -u <username> -t <title> # start chat interface
instagram-cli feed # view posts from people you follow
instagram-cli stories # view stories from people you follow (BETA)
instagram-cli notify # view notifications (inbox, followers, mentions)
# Modify configuration
# The configuration file is located at `~/.instagram-cli/config.ts.yaml`.
instagram-cli config # lists all config
instagram-cli config <key> <value> # set config key to value
instagram-cli config edit # open config file in editorIf you want to use Instagram CLI with AI agents, see one-turn commands that are non-interactive and designed for agents.
[!TIP] You can easily manage multiple accounts with Instagram CLI! Your login for each account will be saved locally and you can switch between them using the
instagram-cli auth switch <username>command or run a certain command with a specific account using the--usernameflag.
Chat Commands
Inside the chat interface and after selecting a thread, you can navigate all interface with 100% keyboard support. When messaging, the following commands are available:
# Select messages to perform actions
:select
:react <emoji | :emoji_name:>
:reply <text>
:unsend
# Media Handling
:upload <path-to-image-or-video>
:download <path-to-save> # Requires :select first to select message
# Navigation
:k # go up
:K # go to top
:j # go down
:J # go to bottom[!TIP] You can quickly include text files or images in a message by using
#followed by the file path. For example,#path/to/file.txtor#path/to/image.png. Usetabandenterto autocomplete file paths. You can include emojis in messages with:emoji_name:e.g.:thumbsup:= 👍 (with fuzzy matching).
Instagram CLI supports mouse interactions as well, so you can click on messages to select them, scroll through the chat, and click to reposition the cursor when typing messages. We're gradually rolling out more mouse support in our TUI!
One-turn Commands (for AI Agents)
These commands are non-interactive (no TUI) — they run once, print to stdout, and exit. They're designed for scripting, piping, and AI agent tool-use. All commands accept -o json for structured JSON output. Example usage includes:
# These are only example usages. Run -h / --help for full manual.
instagram-cli inbox
instagram-cli send <thread> --text "Hey, how are you?"
instagram-cli read <thread> --limit 10 --mark-seen --output json
instagram-cli read <thread> --message-id <id> --download "./photo.jpg"
instagram-cli reply <thread> --message-id <id> --text "Hey, how are you?"
instagram-cli unsend <thread> --message-id <id><thread> accepts a thread ID, username, or fuzzy thread title. Prefer passing thread IDs (from inbox -o json) directly to avoid redundant lookups.
[!TIP] Building an AI agent that uses Instagram? Load
./skills/instagram-skill/SKILL.mdinto your agent's workspace (or point your agent framework at it). It covers all commands, JSON output format, thread resolution, multi-account usage, and a recommended workflow.
npx skills add supreme-gg-gg/instagram-cliDisplaying Images in TUI
When rendering images in the terminal, we automatically select the best image protocol based on your terminal emulator. If you experience issues with image rendering or wish to customize the image protocol, you can change the config setting with instagram-cli config image.protocol <option>. The available options are "ascii", "halfBlock", "braille", "kitty", "iterm2", "sixel".
[!NOTE] Make sure the configured protocol is supported by your terminal (e.g.
sixelanditerm2protocols won't work in Kitty).
We use Ink Picture, our own open-source Ink <Image> component, for displaying images in the terminal. Any related issues or pull requests should be filed on the upstream repository.
Contributing
We welcome contributors! Please see the comprehensive CONTRIBUTING.md file for details on how to get started, create issues, and submit pull requests. It is very important that you follow these instructions because we manage two different clients in the same repository. _Instagram CLI is NOT meant to be used for bot-behaviours, we will not accept contributions that add such features._
Reporting Issues
Occasionally, Instagram may update their API or protocols which can cause certain features to break. If you encounter any issues, please report them on our GitHub Issues page. Make sure to attach the relevant log files located at ~/.instagram-cli/logs/ to help us diagnose and fix the problem quickly. You may want to redact sensitive data like your username for privacy.
Sister projects
We contributed the following extensions to the Ink open-source ecosystem for building Terminal UI apps:
