Quickstart

pip install wirebox

npm install @wirebox-sh/sdk

npm install -g @wirebox-sh/cli

from wirebox import Wirebox

# 1. Initialize client (automatically reads os.environ["WIREBOX_API_KEY"])
with Wirebox() as wb:
    # 2. Create an agent identity — provisions eva@wireboxmail.com instantly
    identity = wb.create_identity(
        "eva",
        display_name="Eva Support",
        description="Autonomous customer triage and support agent"
    )
    print(f"Mailbox ready: {identity.mailbox.email_address}")

    # 3. Bind directly to the agent context
    eva = wb.get_identity("eva")

    # 4. Send an outbound email
    sent = eva.send_email(
        to=["user@example.com"],
        subject="Welcome from Eva",
        body_text="Hello! I am Eva, your AI assistant. My mailbox is fully configured."
    )
    print(f"Message sent: {sent.id}")

    # 5. Read incoming inbox messages
    for msg in eva.iter_emails():
        print(f"[{msg.id}] From: {msg.from_address} | Subject: {msg.subject}")

import { Wirebox } from "@wirebox-sh/sdk";

// 1. Initialize client (automatically reads process.env.WIREBOX_API_KEY)
const wb = new Wirebox();

// 2. Create an agent identity — provisions eva@wireboxmail.com instantly
const identity = await wb.createIdentity({
  agent_handle: "eva",
  display_name: "Eva Support",
  description: "Autonomous customer triage and support agent",
});
console.log(`Mailbox ready: ${identity.mailbox.email_address}`);

// 3. Bind directly to the agent context
const eva = await wb.getIdentity("eva");

// 4. Send an outbound email
const sent = await eva.sendEmail({
  to: "user@example.com",
  subject: "Welcome from Eva",
  text: "Hello! I am Eva, your AI assistant. My mailbox is fully configured.",
});
console.log(`Message sent: ${sent.id}`);

// 5. Read incoming inbox messages
const { messages } = await eva.listMessages({ limit: 10 });
for (const msg of messages) {
  console.log(`[${msg.id}] From: ${msg.from} | Subject: ${msg.subject}`);
}

# 1. Create an agent identity — provisions eva@wireboxmail.com instantly
wirebox identity create eva \
  --display-name "Eva Support" \
  --description "Autonomous customer triage and support agent"

# 2. Send an outbound email
wirebox mail send --identity eva \
  --to user@example.com \
  --subject "Welcome from Eva" \
  --text "Hello! I am Eva, your AI assistant. My mailbox is fully configured."

# 3. Read incoming inbox messages (formatted table)
wirebox mail list --identity eva --limit 10

# 4. Read incoming messages as raw JSON (for subagents or jq piping)
wirebox mail list --identity eva --limit 10 --json