Skip to content

πŸ”§ Fix GitHub repo metadata β€” descriptions, topics, and homepage URLs are missingΒ #121

Description

@adi-singh13

Problem

Almost every public repo in the agentmail-to org has no description, no topics, and no homepage URL. This hurts:

  • GitHub search discoverability β€” repos don't show up for relevant queries
  • GitHub org page appearance β€” wall of blank descriptions looks unfinished
  • SEO β€” GitHub repo pages rank well, but only if they have metadata
  • Developer trust β€” polished repos signal a serious product

Recommended Changes

Run this script with an admin token (the adi-singh13 account is member role, not admin β€” needs org owner):

TOKEN="ghp_YOUR_ADMIN_TOKEN"

# agentmail-python
curl -sX PATCH -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-python \
  -d '{"description":"Official Python SDK for AgentMail β€” the email API for AI agents","homepage":"https://pypi.org/project/agentmail"}'

# agentmail-node
curl -sX PATCH -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-node \
  -d '{"description":"Official TypeScript/Node SDK for AgentMail β€” the email API for AI agents","homepage":"https://www.npmjs.com/package/agentmail"}'

# agentmail-go
curl -sX PATCH -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-go \
  -d '{"description":"Official Go SDK for AgentMail β€” the email API for AI agents","homepage":"https://pkg.go.dev/github.com/agentmail-to/agentmail-go"}'

# agentmail-toolkit
curl -sX PATCH -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-toolkit \
  -d '{"description":"AgentMail integrations for OpenAI Agents SDK, Vercel AI SDK, and MCP","homepage":"https://agentmail.to"}'

# agentmail-mcp
curl -sX PATCH -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-mcp \
  -d '{"description":"AgentMail MCP Server β€” connect AI clients (Claude, Cursor, Windsurf) to email","homepage":"https://mcp.agentmail.to"}'

# agentmail-cli
curl -sX PATCH -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-cli \
  -d '{"description":"Official CLI for AgentMail β€” manage inboxes, send and receive email from the terminal","homepage":"https://docs.agentmail.to"}'

# agentmail-docs
curl -sX PATCH -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-docs \
  -d '{"description":"AgentMail API documentation","homepage":"https://docs.agentmail.to"}'

# agentmail-examples
curl -sX PATCH -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-examples \
  -d '{"description":"Example agents built with AgentMail β€” email agents, sales outreach, and more","homepage":"https://agentmail.to"}'

# agentmail-skills
curl -sX PATCH -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-skills \
  -d '{"description":"AgentMail skills for Claude Code and other AI coding agents","homepage":"https://agentmail.to"}'

# agentmail-schemas
curl -sX PATCH -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-schemas \
  -d '{"description":"AgentMail API schemas and type definitions","homepage":"https://docs.agentmail.to"}'

# agentmail-claude-skill
curl -sX PATCH -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-claude-skill \
  -d '{"description":"Claude Skill that teaches Claude how to build email agents with AgentMail","homepage":"https://agentmail.to"}'

# agentmail-smithery-mcp
curl -sX PATCH -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-smithery-mcp \
  -d '{"description":"AgentMail MCP Server for Smithery","homepage":"https://smithery.ai"}'

# homebrew-tap
curl -sX PATCH -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/homebrew-tap \
  -d '{"description":"Homebrew tap for AgentMail CLI","homepage":"https://agentmail.to"}'

Topics to Add

After descriptions, add topics to key repos (requires PUT /repos/{owner}/{repo}/topics):

# agentmail-python
curl -sX PUT -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-python/topics \
  -d '{"names":["python","sdk","email","ai-agents","email-api","agentmail"]}'

# agentmail-node
curl -sX PUT -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-node/topics \
  -d '{"names":["typescript","nodejs","sdk","email","ai-agents","email-api","agentmail"]}'

# agentmail-go
curl -sX PUT -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-go/topics \
  -d '{"names":["go","golang","sdk","email","ai-agents","email-api","agentmail"]}'

# agentmail-toolkit
curl -sX PUT -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-toolkit/topics \
  -d '{"names":["openai","vercel-ai","mcp","ai-agents","email","agentmail","langchain"]}'

# agentmail-mcp
curl -sX PUT -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-mcp/topics \
  -d '{"names":["mcp","model-context-protocol","claude","cursor","ai-agents","email","agentmail"]}'

# agentmail-cli
curl -sX PUT -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-cli/topics \
  -d '{"names":["cli","email","ai-agents","agentmail","terminal"]}'

# agentmail-examples
curl -sX PUT -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-examples/topics \
  -d '{"names":["examples","email-agent","ai-agents","agentmail","python"]}'

# agentmail-docs
curl -sX PUT -H "Authorization: token $TOKEN" https://api.github.com/repos/agentmail-to/agentmail-docs/topics \
  -d '{"names":["documentation","api-docs","email-api","agentmail"]}'

Why This Matters

  • GitHub repos are often the first thing developers find when evaluating a tool
  • Empty descriptions = missed organic search traffic
  • Topics feed into GitHub Explore and search filters
  • Homepage links drive traffic back to docs/product
  • Takes 2 minutes with an admin token, instant ROI

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions