Troubleshooting

Email issues

My email to the agent bounced

Cause: Email address doesn’t exist or is misspelled.

Fix: Verify the agent name matches exactly. Check your dashboard for the correct email address.

• Free tier: {name}-{hash}@tinyfat.com
• Tiny tier: {name}@tinyfat.com

Agent never responded

Possible causes:

1. Your email isn’t in allowed senders
2. API key is missing or invalid
3. Job failed during processing

Fixes:

1. Check allowed senders in Dashboard → Settings
2. Verify API key in Dashboard → Settings → API Keys
3. Check job history in Dashboard for error messages

Response went to spam

Fix: Add your agent’s email ([email protected]) to your contacts or mark as “not spam”.

Emails not threading properly

Cause: Email client or corporate server modifying headers.

Fix: Try a different email client. Gmail and Outlook usually work well.

Response took too long

Cause: Complex requests take more time. The agent runs one turn per email.

Expected times:

• Simple questions: 10-20 seconds
• Tool use (web search, file ops): 20-60 seconds
• Complex reasoning: 30-90 seconds

If consistently slow, try /model haiku for faster responses.

API key issues

”Invalid API key” error

Cause: API key is malformed, expired, or has insufficient credits.

Fixes:

1. Verify key at console.anthropic.com
2. Check you have credits available
3. Re-enter the key in Dashboard → Settings → API Keys

Usage not showing in Anthropic console

Cause: It can take a few minutes for usage to appear.

Fix: Wait 5-10 minutes and refresh the Anthropic dashboard.

Session issues

Context too large / hitting token limits

Symptoms: Agent mentions context limit, responses get cut off, high costs.

Fixes:

1. Send /compact to compress context
2. Send /clear to start fresh
3. Switch to a longer-context model (all current models support 200k)

Lost conversation history

Cause: Started a new session or used /clear.

Fix: Send /resume to see available sessions, then /resume {hash} to continue one.

Can’t find old session

Cause: Sessions are stored for a limited time.

Fix: Important context should be saved to MEMORY.md for permanent storage.

Model issues

Wrong model being used

Cause: Model preference saved incorrectly.

Fix: Send /model to check current model, then /model haiku|sonnet|opus to change.

Model not available

Cause: Your API key may not have access to all models.

Fix: Check your Anthropic account tier. Some models require higher tiers.

Dashboard issues

Can’t log in

Fixes:

1. Check spam for magic link email
2. Make sure you’re using the same email you signed up with
3. Request a new magic link

Settings not saving

Cause: Browser caching or network issues.

Fix: Hard refresh (Ctrl+Shift+R), try a different browser, check network connection.

Slack issues (Tiny tier)

Bot not responding to @mentions

Fixes:

1. Verify bot is invited to the channel: /invite @yourbot
2. Check event subscriptions are configured in Slack app
3. Verify bot token is entered in Dashboard → Settings

Duplicate messages

Cause: Slack retrying webhook delivery.

Fix: Usually resolves itself. If persistent, check Slack app webhook configuration.

Cost issues

Unexpected high costs

Check:

1. Job history for number of turns
2. Token usage in session footers
3. Model being used (Opus is 15x more expensive than Haiku)

Reduce costs:

• Use /model haiku for simple tasks
• Use /compact regularly to reduce context size
• Don’t send unnecessary messages

Cost not matching Anthropic dashboard

Note: TinyFat shows estimated costs based on token counts. Actual billing comes from Anthropic and may differ slightly due to:

• Caching discounts
• Rounding
• Timing of usage reporting

Getting help

If you’re still stuck:

1. Check job history — Dashboard shows errors for each job
2. Email support — [email protected]
3. Include details:
   • Your agent’s email address
   • Timestamp of the issue
   • Any error messages you see