Chat SDK
databuddy-analytics/Databuddy
Build multi-platform chat bots with Chat SDK (chat npm package).
Send iMessage and SMS from the shell via the @sendblue/cli npm package — outbound sends, contact management, and account setup with no API client or webhook server required.
Install Sendblue CLI
$ npx skills add sickn33/agentic-awesome-skills --skill sendblue-cli -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install sickn33/agentic-awesome-skills sendblue-cli --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/sendblue/sendblue-cli .claude/skills/sendblue-cli && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "sendblue-cli" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/sendblue/sendblue-cli into .claude/skills/sendblue-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sendblue-cli", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/sendblue/sendblue-cliType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add sickn33/agentic-awesome-skills --skill sendblue-cli -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install sickn33/agentic-awesome-skills sendblue-cli --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/sendblue/sendblue-cli .agents/skills/sendblue-cli && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "sendblue-cli" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/sendblue/sendblue-cli into .agents/skills/sendblue-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sendblue-cli", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add sickn33/agentic-awesome-skills --skill sendblue-cli -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install sickn33/agentic-awesome-skills sendblue-cli --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/sendblue/sendblue-cli .cursor/skills/sendblue-cli && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "sendblue-cli" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/sendblue/sendblue-cli into .cursor/skills/sendblue-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sendblue-cli", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/sickn33/agentic-awesome-skills.git --path skills/sendblue/sendblue-cli--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add sickn33/agentic-awesome-skills --skill sendblue-cli -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install sickn33/agentic-awesome-skills sendblue-cli --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/sendblue/sendblue-cli .gemini/skills/sendblue-cli && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "sendblue-cli" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/sendblue/sendblue-cli into .gemini/skills/sendblue-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sendblue-cli", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install sickn33/agentic-awesome-skills sendblue-cliInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add sickn33/agentic-awesome-skills --skill sendblue-cli -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/sendblue/sendblue-cli .github/skills/sendblue-cli && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "sendblue-cli" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/sendblue/sendblue-cli into .github/skills/sendblue-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sendblue-cli", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add sickn33/agentic-awesome-skills --skill sendblue-cli -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install sickn33/agentic-awesome-skills sendblue-cli --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/sendblue/sendblue-cli .opencode/skills/sendblue-cli && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "sendblue-cli" agent skill from https://github.com/sickn33/agentic-awesome-skills/tree/main/skills/sendblue/sendblue-cli into .opencode/skills/sendblue-cli/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sendblue-cli", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
sendblue-cli- GitHub stars
- 47k
- Used in
- 1 other repo
- Token cost
- ~1.8k tokens
- SKILL.md length
- 842 words
- Files
- 1
- Skills in repo
- 1,394
- Repo updated
- First seen
- Licence
- MIT
At a glance
Send iMessage and SMS from the shell via the @sendblue/cli npm package — outbound sends, contact management, and account setup with no API client or webhook server required.
- Works in 4 steps: Install → Set up an account → Send messages → …
- Tasks that involve Webhooks
- SKILL.md covers Overview, When to Use This Skill, How It Works and Command Reference, plus 7 more sections
- Calls npm and npx
What it does
Sendblue CLI is an agent skill from sickn33/agentic-awesome-skills. Send iMessage and SMS from the shell via the @sendblue/cli npm package — outbound sends, contact management, and account setup with no API client or webhook server required.
Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Backend & APIs, covering Webhooks and Messaging and chat bots. It works with npm. The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is MIT.
When your agent uses it
- Tasks that involve Webhooks
- Tasks that involve Messaging and chat bots
Example prompts
- “/sendblue-cli”
Requirements
- Node.js
Workflow steps
4 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 1e53ce2. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
npmnpx
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
github.comsendblue.comdocs.sendblue.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Sendblue CLI loads about 1.8k tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 842 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from sickn33/agentic-awesome-skills at commit 1e53ce2, republished under its MIT licence (© sickn33). 842 words, ~1,826 tokens.
Download SKILL.mdSave it as
.claude/skills/sendblue-cli/SKILL.md (or your agent's skills folder).- name
- sendblue-cli
- description
- Send iMessage and SMS from the shell via the @sendblue/cli npm package — outbound sends, contact management, and account setup with no API client or webhook server required.
- category
- api-integration
- risk
- critical
- source
- community
- source_repo
- sendblue-api/sendblue-cli
- source_type
- official
- date_added
- 2026-05-22
- author
- AnthonyFirth
- tags
- sendblue, imessage, sms, cli, messaging, notifications
- tools
- claude, cursor, gemini
- license
- MIT
Sendblue CLI
Overview
@sendblue/cli is a Node CLI that creates a Sendblue account, provisions an iMessage-enabled number, and sends messages. It is the fastest way to text from a shell, script, or Claude Code hook — no API client, no webhook server, no credentials in env vars. Credentials live at ~/.sendblue/credentials.json (mode 600) and Node.js 18+ is required.
When to Use This Skill
- Use when the user wants to text a phone number from a script, shell, hook, or agent turn (e.g. "text me when X finishes", "ping my phone", "notify on completion").
- Use when the user mentions
sendblueas a CLI/binary or asks to set up the@sendblue/clipackage. - Prefer this skill over [[sendblue-api]] when the work happens in a shell context, one-shot script, cron job, or agent hook.
- Reach for [[sendblue-api]] instead when writing application code that integrates Sendblue, receiving inbound webhooks, or needing features the CLI does not expose (send styles, reactions, group messages, status callbacks, media uploads).
How It Works
Step 1: Install
npm install -g @sendblue/cli # global, exposes `sendblue`
# or one-shot:
npx @sendblue/cli <command>Step 2: Set up an account
sendblue setup runs interactively by default. For CI/scripts, run it in two phases — the first call sends an 8-digit verification code by email, the second consumes it.
sendblue setup --email you@example.com # sends code
sendblue setup --email you@example.com --code 12345678 \
--company my-co --contact +15551234567 # completes setup| Flag | Notes |
|---|---|
--email | Email address |
--code | 8-digit verification code (from the email) |
--company | Lowercase, hyphens/underscores, 3–64 chars |
--contact | First contact, E.164 |
Step 3: Send messages
sendblue send +15551234567 'Hello from Sendblue!'
sendblue messages --inbound --limit 20Phone numbers must be E.164 (+ + country code + digits, no spaces or dashes).
Step 4: Manage contacts and plan
On the free plan, a contact must text your Sendblue number once before outbound sends to that contact will work. After sendblue setup ... --contact +15551234567, have that contact send any text to the printed Sendblue number, then run sendblue contacts to confirm verification.
Command Reference
| Command | Purpose |
|---|---|
sendblue setup | Create account, verify email, set company name, add first contact |
sendblue login | Log in to an existing account |
sendblue send <number> <message> | Send an iMessage |
sendblue messages [--inbound|--outbound] [-n <number>] [-l <count>] | List recent messages |
sendblue add-contact <number> | Register a contact |
sendblue contacts | List contacts and their verification status |
sendblue status | Account/plan info |
sendblue whoami | Show current credentials and verify validity |
Examples
Example 1: Notify when a long task finishes
long_running_thing && sendblue send +15551234567 "✅ done: $(date)"Example 2: Read recent inbound for a specific contact
sendblue messages -n +15551234567 --inbound --limit 50Example 3: Verify creds are good before a batch send
sendblue whoami || sendblue loginExample 4: Wire to a Claude Code Stop hook
To text yourself at the end of every agent turn, register a Stop hook in settings.json that shells out to sendblue send. Defer the actual hook wiring to [[update-config]] and the trigger logic to [[sendblue-notify]] — this skill only owns the CLI invocation.
Best Practices
- ✅ Use E.164 numbers everywhere.
+15551234567, never5551234567or(555) 123-4567. - ✅ Run
sendblue whoamibefore unattended batches to fail fast on stale or missing creds. - ✅ Re-run
setupas the same OS user that owns~/.sendblue/credentials.json. - ❌ Don't
sudo— it writes creds to root's home and the next non-sudo run won't see them. - ❌ Don't embed creds in env vars when the CLI already reads them from the per-user credentials file.
Show full SKILL.md (342 more words)Show less
Limitations
- Outbound-first: there is no built-in webhook server for inbound. Use [[sendblue-api]] webhooks for full inbound handling.
- The CLI does not expose send styles/effects, reactions, group messages, status callbacks, media uploads, or the contacts API beyond basic CRUD. Reach for the HTTP API for those.
- Free-plan accounts require recipient verification before outbound sends succeed.
Security & Safety Notes
- Credentials are written to
~/.sendblue/credentials.jsonwith mode600. Treat that file like an API key — do not commit it, do not copy it across machines without the same posture. - Treat every outbound send, contact setup, login, or account setup action as state-changing. Preview the recipient, message body, and account/email target, then wait for explicit user confirmation before running it.
- Run the CLI as the OS user that owns the credentials file.
sudowrites a separate copy under root's home and silently desyncs. - Outbound messages to phone numbers are not free of consequence — wire
sendblue sendinto hooks or loops only after gating on duration or success conditions to avoid spamming the recipient. - Verification codes arrive by email; treat the address you registered with as a recovery factor for the account.
Common Pitfalls
- E.164 only.
5551234567or(555) 123-4567will fail — always+15551234567. - Free-plan unverified contacts. Outbound to a contact that hasn't texted in first returns an error — have them text your Sendblue number once, then confirm with
sendblue contacts. - Two-step setup in non-interactive mode.
--emailalone only sends the code; you must run a second invocation with--codeand the rest of the flags to finish. - Credentials are per-user.
~/.sendblue/credentials.jsonis owner-only (600). Don'tsudoand pollute root's home — re-running as the same user that ransetupis what works.
Related Skills
@sendblue-api— HTTP/JSON alternative for application code, webhooks, and features the CLI does not expose.@sendblue-notify— Patterns and copy rules for "text me when X is done" workflows that sit on top of this CLI.@update-config— Wiressendblue sendinto Claude Code hooks (Stop,Notification) without owning the message logic.
Links
- README & full flag reference: https://github.com/sendblue-api/sendblue-cli
- Sendblue: https://sendblue.com
- API docs (deeper protocol details): https://docs.sendblue.com
© sickn33, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/sendblue/sendblue-cli of sickn33/agentic-awesome-skills.
Open the folder on GitHubat commit 1e53ce2
Used in 1 other repository
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Sendblue CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Sendblue CLI this skillsickn33/agentic-awesome-skills | 47k | 1 repos | ~1.8k | Automated safety check: Pass | MIT | |
| Chat SDKdatabuddy-analytics/Databuddy | 1.2k | — | ~2.6k | Automated safety check: Pass | AGPL-3.0 | |
| Integrate Whatsappgokapso/agent-skills | 175 | — | ~4.8k | Automated safety check: Pass | None | |
| Paper Feishu Digestchtc66/academic-skills | 359 | — | ~348 | Automated safety check: Pass | MIT | |
| X Twitter ScraperXquik-dev/x-twitter-scraper | 209 | — | ~2.6k | Automated safety check: Pass | MIT | |
| Chat SDK Botslobehub/lobehub | 83k | — | ~1.5k | Automated safety check: Pass | Custom licence |
Similar skills
Integrate Whatsapp
gokapso/agent-skills
Connect WhatsApp to your product with Kapso: onboard customers with setup links, detect connections, receive events via webhooks, and send messages/templates/media.
Paper Feishu Digest
chtc66/academic-skills
monitor recent arxiv papers and produce a chinese digest when the user needs a filtered paper watchlist, a ranked update for agent or rag related topics, or an optional feishu webhook push from…
X Twitter Scraper
Xquik-dev/x-twitter-scraper
Use Xquik to fetch X (Twitter) data or act through a connected account: search, profiles, followers, replies, threads, timelines, media downloads, bulk exports, trends, monitors, signed webhooks…
Chat SDK Bots
lobehub/lobehub
Builds chat bots once for Slack, Teams, Google Chat, Discord, GitHub and Linear with the Chat SDK, covering event handlers, cards, modals, streaming and state adapters.
Skill Publish Notify
ZJU-REAL/Easel
发布通知推送：内容发布成功/失败后，把结果推送到飞书/钉钉/企业微信群机器人、 Telegram、Slack 或任意 webhook。当用户说"发布通知""发到飞书群""通知钉钉""推送到企微" "发布成功提醒""webhook 通知""发布完通知我""群机器人"时使用。纯脚本无第三方依赖。
More from sickn33/agentic-awesome-skills
All 1,394 skills in this repoLiuguang Banlan UI
sickn33/agentic-awesome-skills
Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.
User Thoughts Memory
sickn33/agentic-awesome-skills
Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.
Using LWC Memory and Graphs
sickn33/agentic-awesome-skills
Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.
Find Complementary Founders
sickn33/agentic-awesome-skills
Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.
Whatsapp Cloud API
sickn33/agentic-awesome-skills
Integracao com WhatsApp Business Cloud API (Meta). An agent skill from sickn33/agentic-awesome-skills.
Cline Pilot
sickn33/agentic-awesome-skills
Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.
Related
Works with
Categories
Questions about Sendblue CLI
What does Sendblue CLI do?
Send iMessage and SMS from the shell via the @sendblue/cli npm package — outbound sends, contact management, and account setup with no API client or webhook server required. Sendblue CLI is an agent skill from sickn33/agentic-awesome-skills. Send iMessage and SMS from the shell via the @sendblue/cli npm package — outbound sends, contact management, and account setup with no API client or webhook server required.
When should I use Sendblue CLI?
Sendblue CLI fits situations like: tasks that involve Webhooks; tasks that involve Messaging and chat bots.
How do I install Sendblue CLI in Claude Code?
Run `npx skills add sickn33/agentic-awesome-skills --skill sendblue-cli -a claude-code`. Or copy the skill folder (skills/sendblue/sendblue-cli in sickn33/agentic-awesome-skills) into .claude/skills/sendblue-cli in your project. Claude Code loads it when a task matches its description.
How do I install Sendblue CLI in Codex?
Run `npx skills add sickn33/agentic-awesome-skills --skill sendblue-cli -a codex`. Or copy the skill folder (skills/sendblue/sendblue-cli in sickn33/agentic-awesome-skills) into .agents/skills/sendblue-cli in your project. Codex loads it when a task matches its description.
Can I use Sendblue CLI in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sickn33/agentic-awesome-skills --skill sendblue-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sendblue-cli, .gemini/skills/sendblue-cli, .github/skills/sendblue-cli and .opencode/skills/sendblue-cli in your project.
What does Sendblue CLI need to run?
Going by SKILL.md and its folder, Sendblue CLI needs the command-line tools its instructions call (npm and npx). Our summary lists: Node.js.
Does Sendblue CLI access the network?
SKILL.md names 3 domains. As links in the text: github.com, sendblue.com and docs.sendblue.com. This is read from the text; nothing was executed.
Is Sendblue CLI safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Sendblue CLI use?
Sendblue CLI is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Sendblue CLI use?
About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Sendblue CLI?
Skills that share tags, products or a category with Sendblue CLI: Chat SDK (databuddy-analytics/Databuddy, 1.2k stars), Integrate Whatsapp (gokapso/agent-skills, 175 stars), Paper Feishu Digest (chtc66/academic-skills, 359 stars) and X Twitter Scraper (Xquik-dev/x-twitter-scraper, 209 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Sendblue CLI?
sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,304 GitHub stars. The repository holds 1,394 skills in this directory. The repository was last updated on October 6, 2026.
Source: sickn33/agentic-awesome-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.