Skip to content
Back to search

instagram-cli

Instagram's CLI and TUI client -- The ultimate weapon against brainrot

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/supreme-gg-gg/instagram-cli with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/supreme-gg-gg/instagram-cli'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/supreme-gg-gg--instagram-cli/badge.svg)](/listings/supreme-gg-gg--instagram-cli)

HTML

<a href="/listings/supreme-gg-gg--instagram-cli"><img src="/api/listings/supreme-gg-gg--instagram-cli/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

NPM

Requires Node.js v22 or higher.

npm install -g @i7m/instagram-cli

Homebrew (macOS/Linux)

brew tap supreme-gg-gg/tap
brew install instagram-cli

The formula is available [here](https://github.com/supreme-gg-gg/homebrew-tap/blob/main/Formula/instagram-cli.rb).

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](./instagram-py/README.md).

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-cli

Snap (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-cli

We welcome contributions to add more installation methods.

For installation from source, please refer to the [TypeScript Client Documentation](./DEVELOPMENT.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 162 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Instagram CLI
  2. The ultimate weapon against brainrot. The distraction-free, lightweight, portable Instagram client in your terminal.
  3. <a href="https://trendshift.io/repositories/16231?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-16231" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/16231" alt="supreme-gg-gg%2Finstagram-cli | Trendshift" width="250" height="55"/></a>
  4. [![npm](https://img.shields.io/npm/v/@i7m/instagram-cli?style=flat-square)](https://www.npmjs.com/package/@i7m/instagram-cli)
  5. [![downloads](https://img.shields.io/npm/dm/@i7m/instagram-cli?style=flat-square)](https://www.npmjs.com/package/@i7m/instagram-cli)
  6. ![PyPI](https://img.shields.io/pypi/v/instagram-cli)
  7. [![PyPI Downloads](https://static.pepy.tech/badge/instagram-cli)](https://pepy.tech/projects/instagram-cli)
  8. https://github.com/user-attachments/assets/ddcc5a2d-15da-4cd6-8747-9e7956b32c0b
  9. > [!WARNING]
  10. > 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.
  11. ## Why Instagram CLI?
  12. 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.
  13. 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.
  14. - Chat with your friends without falling into endless brainrot
  15. - Stay updated with post and stories from people around you
  16. - Focus on meaningful, intentional conversations and be productive
  17. - Full keyboard navigation and shortcuts, no mouse, no touchscreens
  18. - Celebrate the art and simplicity of **terminal UI (TUI)**
  19. ## Installation
  20. ### NPM
  21. Requires Node.js v22 or higher.
  22. ```bash
  23. npm install -g @i7m/instagram-cli
  24. ```
  25. ### Homebrew (macOS/Linux)
  26. ```bash
  27. brew tap supreme-gg-gg/tap
  28. brew install instagram-cli
  29. ```
  30. The formula is available [here](https://github.com/supreme-gg-gg/homebrew-tap/blob/main/Formula/instagram-cli.rb).
  31. For installation from source, please refer to the [TypeScript Client Documentation](./DEVELOPMENT.md).
  32. ## CLI Commands
  33. The following commands will be available after installing the package:
  34. ```bash
  35. instagram-cli # display title art
  36. instagram-cli --help # view available commands
  37. # Authentication
  38. instagram-cli auth login --username # login with username and password
  39. instagram-cli auth logout # logout and removes session
  40. instagram-cli auth switch <username> # switch to another saved account
  41. instagram-cli auth whoami # display current default user
  42. # Launches TUI interfaces
  43. instagram-cli chat -u <username> -t <title> # start chat interface
  44. instagram-cli feed # view posts from people you follow
  45. instagram-cli stories # view stories from people you follow (BETA)
  46. instagram-cli notify # view notifications (inbox, followers, mentions)
  47. # Modify configuration
  48. # The configuration file is located at `~/.instagram-cli/config.ts.yaml`.
  49. instagram-cli config # lists all config
  50. instagram-cli config <key> <value> # set config key to value
  51. instagram-cli config edit # open config file in editor
  52. ```
  53. If you want to use Instagram CLI with AI agents, see [one-turn commands](#one-turn-commands-for-ai-agents) that are non-interactive and designed for agents.
  54. > [!TIP]
  55. > You can easily manage multiple accounts with Instagram CLI!
  56. > 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 `--username` flag.
  57. ## Chat Commands
  58. 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:
  59. ```bash
  60. # Select messages to perform actions
  61. :select
  62. :react <emoji | :emoji_name:>
  63. :reply <text>
  64. :unsend
  65. # Media Handling
  66. :upload <path-to-image-or-video>
  67. :download <path-to-save> # Requires :select first to select message
  68. # Navigation
  69. :k # go up
  70. :K # go to top
  71. :j # go down
  72. :J # go to bottom
  73. ```
  74. > [!TIP]
  75. > You can quickly include text files or images in a message by using `#` followed by the file path. For example, `#path/to/file.txt` or `#path/to/image.png`.
  76. > Use `tab` and `enter` to autocomplete file paths. You can include emojis in messages with `:emoji_name:` e.g. `:thumbsup:` = 👍 (with fuzzy matching).
  77. 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!
  78. ## One-turn Commands (for AI Agents)
  79. 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:
  80. ```bash
  81. # These are only example usages. Run -h / --help for full manual.
  82. instagram-cli inbox
  83. instagram-cli send <thread> --text "Hey, how are you?"
  84. instagram-cli read <thread> --limit 10 --mark-seen --output json
  85. instagram-cli read <thread> --message-id <id> --download "./photo.jpg"
  86. instagram-cli reply <thread> --message-id <id> --text "Hey, how are you?"
  87. instagram-cli unsend <thread> --message-id <id>
  88. ```
  89. `<thread>` accepts a thread ID, username, or fuzzy thread title. Prefer passing thread IDs (from `inbox -o json`) directly to avoid redundant lookups.
  90. > [!TIP]
  91. > **Building an AI agent that uses Instagram?** Load [`./skills/instagram-skill/SKILL.md`](./skills/instagram-skill/SKILL.md)
  92. > into your agent's workspace (or point your agent framework at it). It covers all commands, JSON
  93. > output format, thread resolution, multi-account usage, and a recommended workflow.
  94. ```bash
  95. npx skills add supreme-gg-gg/instagram-cli
  96. ```
  97. ## Displaying Images in TUI
  98. 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"`.
  99. > [!NOTE]
  100. > Make sure the configured protocol is supported by your terminal (e.g. `sixel` and `iterm2` protocols won't work in Kitty).
  101. We use [Ink Picture](https://github.com/endernoke/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.
  102. ## Contributing
  103. We welcome contributors! Please see the comprehensive [CONTRIBUTING.md](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._
  104. ### Reporting Issues
  105. 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](https://github.com/supreme-gg-gg/instagram-cli/issues). 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.
  106. ### Sister projects
  107. We contributed the following extensions to the [Ink](https://github.com/vadimdemedes/ink) open-source ecosystem for building Terminal UI apps:
  108. - [Ink Picture, Ink-native image component](https://github.com/endernoke/ink-picture)
  109. - [Wax, Ink routing framework](https://github.com/endernoke/wax).
  110. ## Star History
  111. [![Star History Chart](https://star-history.dera.page/svg?repos=supreme-gg-gg/instagram-cli&type=date&legend=top-left)](https://star-history.dera.page/#supreme-gg-gg/instagram-cli&type=date&legend=top-left)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.