inkbox-cli

inkbox-cli is a skill for Claude Code, Codex from inkbox-ai/inkbox. It costs 81 tokens per session (11,192 once invoked), scanned A, original, MIT.

A command-line tool for using the Inkbox service from a terminal. Inkbox handles identities, email, phone and text messages, encrypted storage, contacts, notes, and webhooks.

In plain words
What is it for?
It helps with mailbox imports, email and SMS workflows, contact management, encrypted vault operations, mail-client setup, signing keys, and webhook tasks.
Why use it?
It gives scripts and developers a consistent way to access Inkbox data and services without manually using a web interface. JSON output is available when another program needs to process the results.

Skill for Claude CodeCodex

Part of the inkbox plugin — 9 skills shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/inkbox-ai/inkbox/inkbox-cli
Any agent
npx skills add inkbox-ai/inkbox --skill inkbox-cli
Clone the repo
git clone --depth 1 https://github.com/inkbox-ai/inkbox

Made for: Claude Code, Codex.

Or install inkbox, the plugin that ships this one along with the rest of its 9 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for inkbox-cli

README.md
[![agentmods](https://agentmods.dev/badge/skills/inkbox-ai/inkbox/inkbox-cli.svg)](https://agentmods.dev/skills/inkbox-ai/inkbox/inkbox-cli)
Your own site
<a href="https://agentmods.dev/skills/inkbox-ai/inkbox/inkbox-cli"><img src="https://agentmods.dev/badge/skills/inkbox-ai/inkbox/inkbox-cli.svg" alt="Measured on agentmods" height="20"></a>
Per session 81 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 11,192 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00081 $0.11192
Opus 5 $0.00041 $0.05596
Sonnet 5 $0.00016 $0.02238
Haiku 4.5 $0.00008 $0.01119

Measured today against content hash 9de85fd7e7be, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

inkbox-cli scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/inkbox-cli/SKILL.md · 827 lines

How it starts

The opening of the file, as written. The whole thing — 827 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Inkbox CLI

Command-line interface for the Inkbox API — identities, email, phone, text/SMS, encrypted vault, mailboxes, phone numbers, signing keys, and webhook utilities.

Auth & Runtime

Set credentials via env vars or global flags:

export INKBOX_API_KEY="ApiKey_..."
export INKBOX_VAULT_KEY="my-vault-key"   # only needed for vault decrypt/create flows

Global options:

--api-key <key>      Inkbox API key (or set INKBOX_API_KEY)
--vault-key <key>    Vault key for decrypt operations (or set INKBOX_VAULT_KEY)
--base-url <url>     Override API base URL
--json               Output as JSON instead of formatted tables

If INKBOX_API_KEY is missing and --api-key is not passed, the CLI exits with an error.

Prefer --json when the result will be parsed or fed into another tool. Use the default table/record output when the user wants a quick human-readable summary. With --json, success stays on stdout and API failures write one structured error object to stderr, retaining error.detail and error.retryAfterSeconds.

Install & Local Repo Usage

Published package:

npm install -g @inkbox/cli

Or run without a global install:

npx @inkbox/cli <command>

Requires Node.js >= 22.

Inside this repository, prefer running the local source instead of assuming a global install:

npm --prefix cli run dev -- <command>

Examples:

npm --prefix cli run dev -- --json identity list
npm --prefix cli run dev -- email list -i support-bot --limit 10

High-Risk Operations

These commands can send real traffic or mutate real resources. Confirm with the user before running them:

  • signup create
  • a2a invites create, a2a invites revoke, and a2a invites accept
  • email send
  • email drafts send
  • text send
  • phone call
  • identity delete
  • email delete
  • email delete-thread
  • email drafts delete
  • vault delete
  • identity update --mail-filter-mode ... / --phone-filter-mode ... (admin-only; flips allow/block semantics for that identity's channel)
  • mailbox update --filter-mode ... (DEPRECATED channel path; admin-only)
  • number release
  • number update --filter-mode ... (DEPRECATED channel path; admin-only)
  • phone incoming-action <action> / number update --incoming-call-action ... (changes what answers that identity's inbound calls — hosted_agent makes the platform voice agent pick up)
  • identity signing-key rotate <handle> (rotates that identity's webhook signing key)
  • signing-key create (DEPRECATED org-level path)

Read the full file on GitHub · 827 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed · +6 lines 9de85fd7e7be
  2. 4d ago First seen · 821 lines · 81 tokens per session scan A d83958099284

Subscribe to this mod's changes

inkbox-cli is a skill published in the GitHub repository inkbox-ai/inkbox (67 stars, last pushed today), licensed MIT. It adds 81 tokens to every session and 11,192 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.