convez.ai
PluginIntegração & APIsIntermediário
cseguinlz

DoubleTick CLI

cseguinlz/doubletick-cli

Rastreie leitura de emails desde o terminal ou com agentes IA

Ver no GitHub
InicialPluginScore · de 0 a 100

CLI e servidor MCP para rastreamento de leitura de emails via Gmail. Permite enviar emails com pixel de rastreamento e verificar se foram abertos, funcionando tanto no terminal quanto integrado a agentes de IA como Claude.

Instalação

$npx convez-ai cseguinlz/doubletick-cli

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
2
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 8 meses
Versão
v1.1.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Monitorar engajamento de emails importantes enviados via CLI
  • Integrar rastreamento de emails em workflows de automação com agentes
  • Verificar status de leitura de emails em lote via terminal
  • Combinar rastreamento de CLI com dados da extensão Chrome DoubleTick

Veredito

Ferramenta prática que expande o DoubleTick para contextos CLI e agentes IA, com integração clara via MCP. Assume conhecimento prévio do produto DoubleTick e requer autenticação Gmail válida.

README

A tradução para o português deste README ainda está na fila.

DoubleTick CLI

Open-source CLI and MCP server for email read tracking via Gmail. Know when your emails are opened — from the terminal.

Works with the DoubleTick backend. Tracks from the CLI show up alongside tracks from the Chrome extension.

Install

npm install -g doubletick-cli

Quick Start

# 1. Log in with your Gmail account (one-time)
doubletick login

# 2. Send a tracked email
doubletick send --to jane@company.com --subject "Q1 Planning" --body "Hi Jane, here are the numbers..."

# 3. Check if they read it
doubletick status --last

Commands

doubletick login

Authenticate with Gmail and DoubleTick. Opens your browser for Google sign-in. One-time setup — credentials are stored locally in ~/.doubletick/credentials.json.

doubletick logout

Remove stored credentials.

doubletick send

Send a tracked email. Injects a read-tracking pixel, sends via Gmail API, and registers the track.

# Send a tracked email (body is markdown by default)
doubletick send --to jane@co.com --subject "Hi" --body "Hello **Jane**"

# HTML body instead of markdown
doubletick send --to jane@co.com --subject "Hi" --body "<h1>Hello</h1>" --html

# Body from file
doubletick send --to jane@co.com --subject "Hi" --body-file ./email.md

# With CC/BCC
doubletick send --to jane@co.com --cc "bob@co.com" --subject "Hi" --body "Hello"

doubletick status

Check if a tracked email has been opened.

# Most recent tracked email
doubletick status --last

# Find by recipient
doubletick status --to jane@company.com

# By tracking ID
doubletick status abc-123

doubletick dashboard

List all your tracked emails with open rates and stats.

doubletick dashboard
doubletick dashboard --limit 50

MCP Server

DoubleTick works as an MCP server so AI agents (Claude Code, Claude Desktop, etc.) can send and track emails natively.

Setup

Add to your Claude configuration:

{
  "mcpServers": {
    "doubletick": {
      "command": "npx",
      "args": ["-y", "doubletick-cli"]
    }
  }
}

You must run doubletick login first — the MCP server uses the same stored credentials.

Tools

ToolDescription
send_tracked_emailSend an email with read tracking
check_tracking_statusCheck if a tracked email has been opened
list_tracked_emailsList recent tracked emails with stats

How It Works

  1. You compose an email (text or markdown)
  2. The CLI converts it to HTML, generates a tracking ID, and injects a 1x1 tracking pixel
  3. The email is sent via the Gmail API
  4. The track is registered with DoubleTick's backend
  5. When the recipient opens the email, the pixel fires and the open is logged
  6. You check the status via doubletick status

The entire DoubleTick backend (pixel serving, open logging, deduplication, device detection) works unchanged. The CLI is just a new way to inject the pixel — replacing the Chrome extension's role for terminal/agent workflows.

Architecture

doubletick CLI / MCP server
  ├── Gmail API        → send emails
  └── DoubleTick API   → register tracks, check status
        ├── GET  /img?t=<id>   → tracking pixel
        ├── POST /track        → register tracked email
        ├── GET  /status?id=   → check opens
        └── GET  /dashboard    → list tracked emails

Requirements

  • Node.js 18+
  • A Gmail account
  • A DoubleTick account (free tier: 5 tracked emails/week)

License

MIT

Ver o original no GitHub

Bom para

Relacionados