evex

Install community agents for the eve framework with one command.
Discover agents built by the community, drop them into your app with shadcn, and publish your own.

Live -> evex.sh  ·  leaderboard  ·  eve docs  ·  contributing

---

evex is the open registry for Eve agents. Browse agent configurations built by the community, add any of them to an existing Eve app with a single shadcn command, and publish your own by opening a pull request — every agent stays code-owned and reviewed.

Highlights

• One command to install — npx shadcn@latest add @evex/<agent> drops an agent's files straight into your Eve app.
• Code-owned and reviewed — agents live in source and ship through pull requests; the database only holds runtime state.
• Browse and discover — search the catalog, filter by category, and sort by most installed, newest, or name.
• Inspect before you install — every agent page lists its files, dependencies, author, and install command.
• Leaderboard and profiles — see the most-installed agents and the authors driving them, with profiles tied to a verified GitHub identity.
• Favorites and install metrics — sign in with an email code or GitHub to save agents; installs are counted across the registry.

Install an agent

Every agent has a one-line install. Add one to your project with the shadcn CLI — the same command shown on each agent's page:

npx shadcn@latest add @evex/code-reviewer

Swap code-reviewer for any agent slug from the catalog. Agents span categories like coding, devops, productivity, and support — browse them all at evex.sh.

Publish an agent

Agents are added and updated by pull request, so authorship and review stay in source control. Each agent is a package under registry/<slug> with its files, dependencies, and author identity declared in registry.json. The full workflow — scaffolding, validation, and the review checklist — is in CONTRIBUTIONS.md.

Registry API

Resource	URL
Catalog	https://evex.sh/r/registry.json
Item	https://evex.sh/r/{name}.json

The registry serves public agent metadata and files. Runtime data — installs, favorites, profiles, and auth — lives in the web app's Postgres database.

Built with

Local development

pnpm install
pnpm dev          # web app on http://localhost:3000

pnpm check             # lint + registry validation (ultracite / biome + zod schema)
pnpm fix               # auto-fix lint and formatting
pnpm typecheck         # web app + packages
pnpm registry:install  # install the agent catalog workspace (registry/)
pnpm typecheck:agents  # typecheck every agent in registry/
pnpm test              # vitest (registry contract + pure-logic tests)
pnpm build             # build the web app and registry artifacts
pnpm db:migrate        # apply database migrations (drizzle)

Requires Node >= 24 and pnpm. Copy apps/web/.env.example to apps/web/.env.local and set DATABASE_URL (Postgres); environment variables are validated at startup. Sign-in uses email one-time codes with optional GitHub OAuth. See AGENTS.md for the full environment and setup notes.

License

MIT © TommyBez

Star history

_{Badges & charts by shieldcn.}