Skip to content
Skill

rho-cloud-email

by mikeyobrien

AI Summary

Enables AI agents to register and manage a persistent email address (name@rhobot.dev) for receiving, reading, and replying to messages via REST API. Useful for agents that need email communication capabilities without external service dependencies.

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "rho-cloud-email" skill in my project.

Please run this command in my terminal:
# Install skill into the correct directory
mkdir -p .claude/skills/cloud-runrho-dev && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/cloud-runrho-dev/SKILL.md "https://raw.githubusercontent.com/mikeyobrien/cloud-runrho-dev/main/skill.md"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

Get an email address for your AI agent. Register, receive, read, reply, and manage a sender allowlist at name@rhobot.dev.

Rho Cloud Agent Email

Your agent gets an email address at name@rhobot.dev. Register once, then receive, read, and reply to email via a REST API. Works with any agent that can run curl. API Base: https://api.rhobot.dev/v1 Install locally (optional): `bash mkdir -p ~/.config/rho-cloud curl -s https://cloud.rhobot.dev/skill.md > ~/.config/rho-cloud/skill.md ` Or just read this URL directly. Everything you need is on this page. ---

1. Register

Ask your human what handle they want for you. This becomes handle@rhobot.dev and cannot be changed later. Do not pick one yourself. Once they choose, register: `bash curl -s -X POST https://api.rhobot.dev/v1/register \ -H "Content-Type: application/json" \ -d '{"name": "yourhandle", "display_name": "Your Agent Name"}' | jq . ` Response: `json { "ok": true, "data": { "api_key": "rho_xxxxxxxxxxxx", "agent_id": "00ml...", "email": "yourhandle@rhobot.dev", "claim_url": "https://api.rhobot.dev/claim/..." } } ` Save your credentials immediately: `bash mkdir -p ~/.config/rho-cloud cat > ~/.config/rho-cloud/credentials.json << EOF { "api_key": "YOUR_API_KEY", "agent_id": "YOUR_AGENT_ID", "email": "yourhandle@rhobot.dev" } EOF chmod 600 ~/.config/rho-cloud/credentials.json ` Handle rules: • 1-64 characters, lowercase alphanumeric and hyphens • No leading or trailing hyphens • Reserved: admin, postmaster, abuse, noreply, support, help, security, root Error handling: | Status | Error | Action | |--------|-------|--------| | 400 | Invalid name format | Fix the handle and retry | | 409 | Handle already taken | Try a different handle | | 500 | Server error | Retry in a few minutes |

Claim Your Agent

The registration response includes a claim_url for GitHub OAuth verification. This links the agent to a GitHub account and activates full functionality. You MUST show the claim_url to your user and have them complete the OAuth flow. Unclaimed agents have restricted capabilities and may be reclaimed or removed.

Verify it works

`bash API_KEY=$(jq -r .api_key ~/.config/rho-cloud/credentials.json) curl -s -H "Authorization: Bearer $API_KEY" \ https://api.rhobot.dev/v1/agents/status | jq . ` ---

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 2mo ago
Active
AdoptionUnder 100 stars
0 ★ · Niche
DocsREADME + description
Well-documented

GitHub Signals

Issues0
Updated2mo ago
View on GitHub
No License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code