IG Harness
Shudesu/ig-harness-ossReviewed by AI
Checked by RepoPicks Radar on
What is IG Harness?
IG Harness automates Instagram direct messages for a business or creator account. Someone comments on your post, the tool sends them a DM, checks whether they follow you, hands over the promised file or link, then sends follow-up messages on a delay. It also keeps a contact list with tags and notes, replies from a dashboard, tracks link clicks and can post content. One command deploys it to your own free Cloudflare account; you need Node 22, an Instagram professional account and a Meta developer app. A bundled MCP server lets Claude Code drive it.
IG Harness is free and open source (MIT) and can replace ManyChat, Chatfuel, and SendPulse.
How easy is it to install IG Harness?
D · terminal, several tools or a specific graphics card · Windows
- Windows D
- macOS D
- Linux D
Same on all three systems, with Linux no harder than the others: there is nothing to download and open. You need Node 22 and pnpm, then `npx create-ig-harness` logs into Cloudflare, creates the database and storage and deploys the service and dashboard; before that you have to set up an Instagram professional account, a Meta developer app with webhooks, and several secrets by hand. The program itself then runs on Cloudflare, not on your computer.
Coming soon: install in 1 click with the RepoPicks app.
IG Harness on GitHub
- Stars
- 63on Nov 10, 2026
- Downloads
- —all releases
- Growth
- —no gain in the last reading
Stars over time
Facts
- Runs on
- Windows, macOS, Linux
- You need to install
- Node.js
- To build from source
- Node.js
- Disk space
- 100 MB–500 MB · estimate
- Accounts or keys
- Meta / Instagram Graph API (access token and app secret), Cloudflare account (Workers, D1, R2, Pages), LINE (only to link Instagram followers with LINE friends)
- Cost
- Free · The software costs nothing (MIT). The README says the Cloudflare account and its usage, a domain, and any AI service you connect are paid separately, and that Cloudflare's free D1 plan starts returning errors once the daily read and write limits are reached.
- License
- MIT (Permissive)
- Last change on GitHub
- Nov 3, 2026
IG Harness risk signals (7)
- Attentiondepends on meta approval and your account
README, "Standard Accessの壁について": Meta's Standard and Advanced Access depend on who owns the account and on App Review, and the author writes that it is not guaranteed that every feature works without review. The health endpoint even reports "凍結検知" (freeze detection) and token expiry per account, so the service can stop working if Meta restricts the account or the app.
AI review
- Attentionsecrets stored in plain text by default
.env.example, TOKEN_ENCRYPTION_KEY: "Without it, app secrets / LINE keys stay plaintext, warn once per isolate, and their scheduled encryption migrations are skipped." The key is optional in the example file, so an install that skips it keeps Instagram and LINE credentials unencrypted in the database.
AI review
- Attentionstores your followers personal data
README, CRM section: followers are registered automatically from webhooks with profiles, custom metadata, tags, form answers, click tracking and full conversation logs, kept in your Cloudflare D1 database. .env.example sets MESSAGES_RETENTION_DAYS=0, which "preserves existing history", that is keeps messages forever unless you change it.
AI review
- Attentionai assistant gets full control
README, "運用上の権限と更新": "MCPへowner/adminキーを渡すと、DM送信・一斉配信を含む管理権限を渡します" — giving the MCP server an owner or admin key hands over the right to send DMs and mass broadcasts; only IG_HARNESS_READ_ONLY=true keeps the writing tools out.
AI review
- Infopublished releases lag the code
package.json says version 0.12.0, but the newest GitHub release is v0.4.6 from 2026-04-25 while the last commit is from 2026-11-03. Anyone following the releases page is six months behind what the repository contains.
AI review
- Infosupporting material written by the author
README, "公式情報・検証資料": the research sites, catalogues and wiki it cites are all run by the developer, and the text says so plainly: "各Researchサイトは開発元が運営する一次情報であり、独立した第三者レビューではありません" (they are not independent third-party reviews). The comparison table names the paid competitors only as "A社" and "B社".
AI review
- Infomain documentation in japanese
The main README, the setup video and the wiki are in Japanese; English, Spanish, Korean and Chinese READMEs exist in the repository, but the detailed guides under docs/ and the linked wiki article are Japanese.
AI review
Evidence is shown in its original language.
What Radar could not check about IG Harness
- whether Meta grants the permissions your use needs, and how long approval takes
- whether a real account stays within Cloudflare's free limits once message volume grows
- whether the automated messages follow Instagram's current rules for your country and account type
- what the npm packages (create-ig-harness, the SDK and the MCP server) do when they run, compared with the code in this repository
- how well the one-command setup copes when a step fails halfway through