Skip to content

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

@adi-singh13

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
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions