# evex

> evex is the community registry for eve agents, reusable agents built on eve, Vercel's agent framework. Browse configurations, preview every file before install, and add agents with one shadcn command.

evex is the community registry for reusable eve agent configurations. Developers browse agents, preview every file an install will write, and add agents to eve projects with a single shadcn command.

## What is evex?

evex is a shadcn-compatible registry for eve agents. Each registry item packages an agent's config, instructions, skills, tools, and subagents under the standard `agent/` directory layout used by the eve framework.

## How to install an agent

1. Run `npx shadcn@latest add @evex/{slug}` from your eve app root.
2. Review the generated files and configure any required credentials before running the agent.

## Key pages

- [Browse agents](https://www.evex.sh/): Search and filter the full agent catalog
- [Docs](https://www.evex.sh/docs): How to install agents, use the registry API, and publish your own agent
- [Learn](https://www.evex.sh/learn): Decision guides for Eve, AI agents, MCP, shadcn registries, and framework comparisons
- [Leaderboard](https://www.evex.sh/leaderboard): Most installed agents and top authors
- [GitHub repository](https://github.com/TommyBez/evex): Source, issues, and contribution guide
- [eve framework docs](https://eve.dev/docs/introduction): Framework documentation

## Docs

- [Introduction](https://www.evex.sh/docs.md): Install community eve agents into your project with one command and own every file they write. What evex is and how the shadcn-compatible registry works.
- [Installation](https://www.evex.sh/docs/installation.md): Add any evex agent to your eve project with npx shadcn add. Prerequisites, what the CLI writes, and how to configure and verify the agent after install.
- [Registry](https://www.evex.sh/docs/registry.md): Fetch the evex catalog at /r/registry.json and any agent at /r/{slug}. Endpoints, the @evex shadcn namespace, and machine-readable llms.txt resources.
- [MCP](https://www.evex.sh/docs/mcp.md): Browse and install evex agents from Cursor, VS Code, or Claude Code through the shadcn MCP server. Setup steps and example prompts for @evex/{slug} items.
- [Publishing](https://www.evex.sh/docs/publishing.md): Add your agent to evex by pull request: scaffold with registry:new, fill in meta.docs, validate with the generator, and pass CODEOWNERS and review.

## Guides

- [MCP server for AI agents: what it gives you and what it does not](https://www.evex.sh/learn/mcp-server-for-ai-agents.md): A practical guide to MCP servers for agent builders: tools, resources, prompts, permissions, and where MCP stops.
- [Agentic workflows: when software should decide the next step](https://www.evex.sh/learn/agentic-workflows.md): How to decide when a workflow should be agentic, deterministic, or a hybrid of both.
- [AI agent frameworks: the practical checklist before you choose](https://www.evex.sh/learn/ai-agent-frameworks.md): A practical checklist for comparing LangGraph, CrewAI, AutoGen-style systems, Eve, and other agent frameworks.
- [AI agent tools: the safe way to give models actions](https://www.evex.sh/learn/ai-agent-tools.md): How to design agent tools with narrow authority, typed inputs, clear descriptions, and observable results.
- [MCP vs skills: do you need a connection or a playbook?](https://www.evex.sh/learn/mcp-vs-skills.md): A grounded distinction between MCP servers, tools, resources, prompts, and skills for teams extending AI agents.
- [Agent registry: discovery without trust is just a list](https://www.evex.sh/learn/agent-registry.md): What an AI agent registry must expose before developers can reuse agents safely.
- [Shadcn registry for agents: installing workflows as source files](https://www.evex.sh/learn/shadcn-registry-for-agents.md): How the shadcn registry model applies to AI agent workflows, where users need source files rather than opaque packages.
- [LangGraph vs CrewAI: graph control or role-based crews?](https://www.evex.sh/learn/langgraph-vs-crewai.md): A builder-focused comparison of LangGraph and CrewAI, with Eve as a file-based reference point.

## Agents

- [Programmatic SEO Agent](https://www.evex.sh/agents/programmatic-seo-agent.md): Weekly scheduled agent that grows a product's organic traffic with programmatic SEO: it checks the product's GitHub repository out into its sandbox, discovers and validates keyword opportunities with DataForSEO, researches each target with the Parallel web search API, generates batches of SEO-optimized pages matching the repo's content conventions, and pushes them as a pull request for human review.
- [Brand Visual Asset Generator](https://www.evex.sh/agents/brand-visual-asset-generator.md): Generate brand-aligned SVG asset packs for SaaS products using Context.dev brand extraction and a Quiver Arrow SVG tool.
- [OpenUI Assistant](https://www.evex.sh/agents/openui-assistant.md): An Eve agent that streams OpenUI Lang generative UI using the official openuiChatLibrary, with demo weather, stock, and search tools from the openui-chat example.
- [Eve Agent Builder](https://www.evex.sh/agents/eve-agent-builder.md): An Eve coding agent that creates Eve agents, runs their checks, deploys them to Vercel, and verifies the live routes.
- [Branded SEO Page Builder](https://www.evex.sh/agents/branded-seo-page-builder.md): Generate an on-brand, SEO-optimized HTML page from a domain using Context.dev brand, content, and styleguide data.
- [X Draft Assistant](https://www.evex.sh/agents/x-draft-assistant.md): A scheduled Eve agent that scans a configured set of X (Twitter) profiles every day, surfaces hot topics from their recent posts, researches each topic with the \[Parallel\](https://parallel.ai/) web search API, and creates **three draft candidates** for X in \[Typefully\](https://typefully.com) so a human can review and publish them.
- [X Hot Topic Digest](https://www.evex.sh/agents/x-hot-topic-digest.md): A scheduled Eve agent that scans a configured set of X (Twitter) profiles every day, surfaces hot topics from their recent posts, researches each topic with the \[Parallel\](https://parallel.ai/) web search API, and delivers an HTML digest by email through \[Resend\](https://resend.com).
- [Supabase Data Analyst](https://www.evex.sh/agents/supabase-data-analyst.md): A Slack-native Eve analyst for a single Supabase project that only runs read-only SQL queries. It exposes just supabase__list_tables and supabase__execute_sql through an MCP client connection to the hosted Supabase MCP server; no write, migration, Edge Function, branch, storage, logs, advisors, account, or docs tools are available.
- [Postgres Data Analyst](https://www.evex.sh/agents/postgres-data-analyst.md): An Eve-native Slack analyst for a single Postgres database. It answers Slack mentions and DMs, inspects schema metadata, and runs bounded read-only SQL through authored tools.
- [Code Reviewer](https://www.evex.sh/agents/code-reviewer.md): Review GitHub pull requests from a native GitHub App channel. Mention `@code-reviewer` on a pull request to publish a GitHub review with inline comments, optional suggestion blocks, and Upstash-backed rate limiting for public repositories.
- [Linear Operations Agent](https://www.evex.sh/agents/linear-operations-agent.md): An Eve agent for Linear operations across Linear, Slack, and scheduled runs.

## Machine-readable resources

- [Full content dump](https://www.evex.sh/llms-full.txt): Every guide and agent in one markdown document
- Markdown mirrors: append `.md` to any agent or guide URL for a text/markdown version
- [shadcn registry catalog](https://www.evex.sh/r/registry.json): Machine-readable agent catalog
- Registry items: `https://www.evex.sh/r/{slug}` serves each agent as a shadcn registry item

## Publishing

Authors add agents by opening a pull request to the evex repository. Each agent lives under `registry/{slug}` with a `registry.json` manifest.

## Contact

- GitHub: https://github.com/TommyBez/evex
- Site: https://www.evex.sh