Shared auth, global flags, formatting rules, and security for the Partiful CLI
partiful auth login <phone>
partiful auth login +12065551234
Phone-based authentication. Prefer E.164 format (e.g., +12065551234); US numbers without +1 are normalized automatically.
imsg, Android via termux-sms-list), auto-retrieves the code.| Flag | Description |
|---|---|
--code <code> | Provide verification code directly (skip SMS wait) |
--no-auto |
| Disable automatic SMS retrieval |
partiful auth status
PARTIFUL_TOKEN environment variable~/.config/partiful/auth.json| Flag | Description |
|---|---|
--format <json|table|csv> | Output format (default: json) |
--dry-run | Preview without making changes |
--yes | Skip confirmation prompts |
--force | Override safety checks |
--verbose | Verbose logging to stderr |
--output <file> | Write output to file |
--no-color | Disable colored output |
{ "status": "success", "data": { ... }, "metadata": { "count": 5 } }
{ "status": "error", "error": { "code": 2, "type": "AUTH_ERROR", "message": "Token expired" } }
| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | API error |
| 2 | Auth error |
| 3 | Validation error |
| 4 | Not found |
| 5 | Internal error |
✅ 2026-04-01T19:00
✅ 2026-04-01 7pm
❌ Apr 1 7pm
❌ 04/01 7pm
Default timezone: America/Los_Angeles. Use --timezone for other zones.
Partiful renders plain text. No markdown.
✅ "🎮 Game Night!\n\nBring your favorite board games.\nSnacks provided."
❌ "**Game Night!**\n\n- Bring board games\n- Snacks provided"
Use emoji for visual breaks. Use \n for newlines. No **, - lists, or # headers.
Always double-check AM/PM, especially for morning events. The CLI echoes back the parsed time.
Discover command parameters programmatically:
partiful schema events.create
partiful schema guests.invite
--dry-run to preview destructive operations.~/.config/partiful/ with 0600 permissions.--verbose output.