ledachat
LedaChat plugins for Claude Code: Instagram Comment to DM automations.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 20 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/kingscrosslabs/ledachat 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/kingscrosslabs/ledachat'
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
Markdown
[](/listings/kingscrosslabs--ledachat)HTML
<a href="/listings/kingscrosslabs--ledachat"><img src="/api/listings/kingscrosslabs--ledachat/badge.svg" alt="findsafeskills safety rating" /></a>Install
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.
.claude-plugin/marketplace.json · Manifest · 13 lines
- {
- "name": "ledachat",
- "owner": { "name": "LedaChat", "email": "hello@ledachat.com", "url": "https://www.ledachat.com" },
- "description": "LedaChat plugins for Claude Code: Instagram Comment to DM automations.",
- "plugins": [
- {
- "name": "ledachat",
- "source": "./plugins/ledachat",
- "description": "Create, run and manage Instagram Comment to DM automations from Claude.",
- "category": "marketing"
- }
- ]
- }
README.md · README · 158 lines
- <p align="center">
- <a href="https://www.ledachat.com">
- <img src="./.github/assets/logo.svg" width="120" height="120" alt="LedaChat logo" />
- </a>
- <h1 align="center">LedaChat</h1>
- <p align="center">
- Free, open-source Instagram Comment to DM automations. A ManyChat alternative you can run yourself.
- </p>
- </p>
- <p align="center">
- <a href="https://github.com/kingscrosslabs/ledachat/actions/workflows/ci.yml?query=branch%3Amain"><img src="https://img.shields.io/github/actions/workflow/status/kingscrosslabs/ledachat/ci.yml?branch=main&label=CI" alt="CI status" /></a>
- <a href="https://github.com/kingscrosslabs/ledachat/blob/main/LICENSE"><img src="https://img.shields.io/github/license/kingscrosslabs/ledachat?color=702EC7" alt="MIT license" /></a>
- <img src="https://img.shields.io/github/package-json/v/kingscrosslabs/ledachat?color=702EC7&label=version" alt="LedaChat version" />
- <img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Fkingscrosslabs%2Fadeli-chat%2Fmain%2Fpackage.json&query=%24.engines.node&label=node&color=339933&logo=nodedotjs&logoColor=white" alt="Node.js version" />
- <a href="https://www.npmjs.com/package/@adeli/sdk"><img src="https://img.shields.io/npm/v/@adeli/sdk?label=%40adeli%2Fsdk&color=0a807a" alt="@adeli/sdk on npm" /></a>
- <a href="https://www.tryadeli.com"><img src="https://img.shields.io/badge/powered%20by-Adeli-0a807a" alt="Powered by Adeli" /></a>
- </p>
- <p align="center">
- <a href="https://www.ledachat.com">Website</a>
- <span> • </span>
- <a href="#deploy-to-vercel">Self-host</a>
- <span> • </span>
- <a href="#use-with-claude-mcp">MCP server</a>
- <span> • </span>
- <a href="https://www.tryadeli.com">Powered by Adeli</a>
- <span> • </span>
- <a href="https://www.tryadeli.com/docs/api">Adeli API reference</a>
- <span> • </span>
- <a href="docs/PRD.md">Spec</a>
- </p>
- <br />
- ## Introduction
- When someone comments a keyword on your post, LedaChat replies to their comment and sends them a DM with your link. Use it at [ledachat.com](https://www.ledachat.com), or deploy your own copy to Vercel in a few minutes.
- - **Comment to DM:** a matching comment gets a public reply and an opening DM with a button, and a tap sends the final DM with your link
- - **Follow gate:** ask people to follow you before the link arrives
- - **Your own workspace:** every person who signs in gets their own Instagram account, automations, stats and webhook
- - **Works with AI agents:** an MCP server lets Claude, ChatGPT, Cursor and others build and manage your automations
- - **Nothing to sign up for but Google:** Instagram calls run through the [Adeli](https://www.tryadeli.com) API, so the people using your install never need an Adeli account
- - **Open source:** MIT licensed, Next.js and Postgres (or PGlite locally)
- See [docs/PRD.md](docs/PRD.md) for the spec and build plan, and [docs/brand.md](docs/brand.md) and [docs/design.md](docs/design.md) for the brand and design system.
- ## Run it locally
- ```bash
- corepack enable
- yarn install
- cp apps/web/.env.example apps/web/.env.local # then set ADELI_API_KEY (see "Get your Adeli API key")
- yarn dev
- ```
- Open http://localhost:3030 and click **Connect Instagram**. Nothing is mocked. Every Adeli call goes through [`@adeli/sdk`](https://www.npmjs.com/package/@adeli/sdk).
- Locally `ADELI_API_KEY` is the only variable you need: the database is PGlite in `apps/web/.data`, and without Google variables there's no login. `apps/web/.env.example` lists the optional ones. `apps/web/.env.local` is the only env file.
- The repo is Yarn workspaces:
- | Path | What | Dev |
- | --- | --- | --- |
- | `apps/web` | The app: automations, Instagram, webhooks, MCP | `yarn dev` (port 3030) |
- | `apps/landing-page` | The static marketing site | `yarn dev:landing` (port 3031) |
- | `packages/ui` | Theme tokens and components both apps share | |
- `yarn typecheck`, `yarn lint`, `yarn test` and `yarn build` run in every workspace.
- ## How it uses Adeli
- One LedaChat install uses one Adeli organization, through the API key in `ADELI_API_KEY`. Every person who signs in gets their own [profile](https://www.tryadeli.com/docs/api/profiles/create-profile) in that organization, created when they sign up and named after them (their Google name and email). Their Instagram account, posts and webhook all live on that profile, and LedaChat only ever reads or writes the signed-in person's own profile. People never need an Adeli account of their own: **Connect Instagram** runs Instagram Login through Adeli.
- ## Deploy to Vercel
- 1. **Import the repo** in Vercel and set **Root Directory** to `apps/web`. The other defaults work: the `vercel-build` script applies database migrations, then runs `next build`. Optionally, set **Ignored Build Step** to `sh scripts/vercel-ignored-build-step.sh` so production only redeploys when the app or `packages/ui` changed. It also skips preview deploys, so leave it empty if you want previews.
- 2. **Add Postgres.** In the project's Storage tab, add Neon from the Marketplace and connect it. It sets `DATABASE_URL`.
- 3. **Create a Google OAuth client** in Google Cloud Console (APIs & Services, Credentials, OAuth client ID, type "Web application"). Add the authorized redirect URI `https://<your-domain>/api/auth/callback/google`.
- 4. **Get an Adeli API key** (see "Get your Adeli API key" below).
- 5. **Set the environment variables** below, then redeploy.
- 6. **Allowlist the connect redirect.** In Adeli, under Settings, OAuth, add `https://<your-domain>/connect` so people can connect Instagram from LedaChat.
- 7. **Sign in with Google.** Everyone who signs in gets their own workspace: their own Adeli profile, Instagram account, automations and webhook. Nobody sees anyone else's. Set `ALLOWED_EMAILS` to limit who can sign in.
- 8. **Click Connect Instagram.** Adeli runs Instagram Login for your profile, then LedaChat registers a webhook just for you.
- | Variable | Required | Notes |
- | --- | --- | --- |
- | `ADELI_API_KEY` | Yes | Your Adeli API key, `rk_live_...`. Every user's profile is created in its organization. |
- | `ADELI_API_BASE_URL` | No | Leave empty for the hosted Adeli. Set it only if you run your own Adeli. |
- | `DATABASE_URL` | Yes | Set by the Neon integration. Use the pooled connection string. |
- | `BETTER_AUTH_SECRET` | Yes | Random, at least 32 characters: `openssl rand -base64 32`. Also encrypts MCP API tokens, so keep it stable. |
- | `GOOGLE_CLIENT_ID` | Yes | From the Google OAuth client. |
- | `GOOGLE_CLIENT_SECRET` | Yes | From the Google OAuth client. |
- | `ALLOWED_EMAILS` | No | Comma-separated emails that may sign in. Empty: anyone with Google can sign in. |
- | `BETTER_AUTH_API_KEY` | No | A [Better Auth Infrastructure](https://better-auth.com/docs/infrastructure/getting-started) project key. Set it to see and manage your users and sessions in its dashboard. |
- | `LEDACHAT_BRANDING` | No | Free-plan users get a "Powered by LedaChat" message after the Final DM. Set to `off` to turn it off for everyone. |
- | `APP_URL` | No | Set it when you use a custom domain. Defaults to the Vercel production domain. |
- | `NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN` | No | PostHog project token (`phc_...`) for product analytics. Empty: nothing is sent. See [docs/analytics.md](docs/analytics.md). |
- | `NEXT_PUBLIC_POSTHOG_HOST` | No | `https://us.i.posthog.com` (default) or `https://eu.i.posthog.com`. |
- | `STRIPE_SECRET_KEY` | No | Hosted LedaChat only. **Leave empty to self-host**: without it nothing is limited (turn branding off with `LEDACHAT_BRANDING`). See [docs/billing.md](docs/billing.md). |
- | `STRIPE_WEBHOOK_SECRET` | No | Hosted only, with `STRIPE_SECRET_KEY`: the signing secret of the `https://<app>/api/stripe/webhook` endpoint. |
- | `SLACK_BILLING_ALERT_WEBHOOK_URL` | No | Slack incoming webhook for billing alerts. Empty: none are sent. |
- | `SLACK_SIGNUP_WEBHOOK_URL` | No | Slack incoming webhook for sign-ups and automations going live. Empty: none are sent. |
- | `LOOPS_API_KEY` | No | Loops API key for the welcome email on sign-up. Empty: no email is sent. See [docs/email.md](docs/email.md). |
- | `NEXT_PUBLIC_POSTHOG_UI_HOST` | No | `https://us.posthog.com` (default) or `https://eu.posthog.com`, for links from the toolbar. |
- | `GTM_ID` | No | Google Tag Manager container ID (`GTM-XXXXXXX`), loaded on every page. Empty: no tag. See [docs/analytics.md](docs/analytics.md). |
- The Adeli API key stays on the server. It's never sent to the browser, and nobody enters a key in the app.
- Google sign-in only works on domains registered in the OAuth client, so preview deployments with random URLs can't sign in unless you add them.
- ### Landing page (optional)
- Self-hosting needs only the app. The marketing site in `apps/landing-page` is a second Vercel project: Root Directory `apps/landing-page`, Ignored Build Step `sh scripts/vercel-ignored-build-step.sh`, and `APP_URL` set to the app's address (for example `https://app.example.com`), which its sign-in links point to. A production build without `APP_URL` fails. Set `GTM_ID` there too to load Google Tag Manager on the marketing site.
- To test the whole flow against a local Adeli dev server, with a real comment triggering a real DM, follow [docs/local-development.md](docs/local-development.md).
- ## Use with Claude (MCP)
- LedaChat is also an MCP server at `https://<your-domain>/mcp`, so Claude can list, create and manage your automations: "make a Comment to DM automation for my latest reel that sends the GUIDE link", "pause everything on that post", "how did last week's automations do".
- Open **Connect to AI Agent** in the app sidebar (`/mcp-apis`). It has a setup guide for Claude, ChatGPT (and Codex), Cursor, Perplexity and any other MCP client, with your URL filled in.
- - **Claude, ChatGPT, Cursor and Perplexity** sign in with Google (OAuth) and ask what they may do. Turn off "changes" for a read-only connection. Disconnect any of them under **Connected apps**. This needs Google sign-in, so it's off in local no-login mode.
- - **Claude Code plugin** (hosted LedaChat): this repo is also a plugin marketplace. In Claude Code, run
- ```
- /plugin install ledachat --marketplace kingscrosslabs/ledachat
- ```
- (or `/plugin marketplace add kingscrosslabs/ledachat`, then `/plugin install ledachat@ledachat`), then type `/mcp` and choose Authenticate. The plugin lives in `plugins/ledachat`.
- - **Claude Code** (any install):
- ```bash
- claude mcp add --transport http ledachat https://<your-domain>/mcp
- ```
- then type `/mcp` in Claude Code and choose Authenticate.
- - **Other MCP clients:** use the server URL with `Authorization: Bearer <token>`.
- API tokens start with `adc_`. Every user gets a **Default** token, and you can create more that are read only or expire after 30, 90 or 365 days. Tokens are stored as a hash plus an encrypted copy, so you can reveal and copy them again later, as with Adeli's API keys. Tokens created before that stay hidden. A token or connection only reaches your own automations.
- A new user can start from their agent: after signing in, every tool answers with a `setup` block until Instagram is connected, and `connect_instagram` gives them a one-time link (single use, 15 minutes) that opens LedaChat signed in to **Continue with Instagram**. Clients that support URL elicitation show it as a prompt.
- Tools: `get_workspace`, `connect_instagram`, `list_automations`, `get_automation`, `list_posts`, `create_automation` (always a draft), `update_automation`, `go_live`, `pause_automation`, `duplicate_automation`, `delete_automation`, `reset_runs`, `list_audience` (who engages the most, across automations or for one). They use the same validation as the editor, so an automation Claude takes live passes the same checks.
- ## Get your Adeli API key
- Whoever runs the install needs one Adeli API key. The people who sign in to LedaChat don't.
- 1. **Create an Adeli account.** Go to [app.tryadeli.com](https://app.tryadeli.com/sign-in) and sign in with Google. Your first sign-in creates your organization.
- 2. **Create an API key.** Open [API keys](https://app.tryadeli.com/settings/api-keys), label it "LedaChat", and click **Create key**. It needs to be able to create profiles, connect accounts, read posts, reply to comments, send messages and manage webhooks.
- 3. **Copy the key now.** Adeli shows it only once. It starts with `rk_live_`.
- 4. **Set it as `ADELI_API_KEY`:** in `apps/web/.env.local` for local development, or in the Vercel project's environment variables. Restart or redeploy afterwards.
- Never commit a key. If Adeli stops accepting it, LedaChat shows a banner on every page until you replace it.
- ## Notes
- - Follow Meta's Platform Terms and Instagram's messaging policies when you run automations.
- - The code is [MIT licensed](LICENSE). The Adeli logo in `apps/landing-page/public/brand/` is used with permission and isn't covered by the MIT license; forks should swap it.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.