docs/quickstart

البداية السريعة

أربعة أوامر من الصفر لحد إنبوكس مرمي. لسه مش مثبت؟ عندك أربع طرق — Homebrew أو npm أو npx أو من المصدر.

المسار كله

البلوك ده جاهز للصق من أول سطر لآخر سطر، بالتعليقات. كل حاجة تانية flags اختيارية.

shell: الصق البلوك كله
# 0: sanity check, prints providers, proves install + network work
tossinbox providers

# 1: create a fresh disposable address (saved locally)
tossinbox spawn

# 2: submit the address in the signup form FIRST; once the site has
#     sent its email, block until the code lands and print it
tossinbox wait --code --from noreply@example.com --timeout 120

# 3: delete it server-side and wipe the local record
tossinbox toss

خطوة 2 بتفرض إنك حطيت العنوان في فورم تسجيل قبل كده. TossInbox بيستقبل — عمره ما بيبعت.

مخرجات يقرأها البرنامج

كل أمر بيقبل --json: نفس البيانات ومن غير ألوان ANSI. ده هو العقد اللي الوكلاء واثقين فيه.

shell → json
tossinbox spawn --json
{ "ok": true,
  "inbox": { "address": "qwd6996p1lbc@uberip.com", "provider": "mailtm",
             "token": "…", "password": "…", "createdAt": "…" } }
# token + password are yours alone, they live in ~/.tossinbox/state.json (0600)

قايمة الـ flags الكاملة على صفحة مرجع الـ CLI.