whatisgithub

What is ai-tool-elements?

omavashia2005/ai-tool-elements — explained in plain English

Analysis updated 2026-07-26

3TypeScriptAudience · developerComplexity · 2/5Setup · easy

In one sentence

A TypeScript package providing ready-made React components that display visual cards when an AI agent uses external tools like Slack, Gmail, or Notion, so developers don't have to build them from scratch.

Mindmap

mindmap
  root((repo))
    What it does
      Visual tool cards
      1000+ tool catalog
      Tool call states
    Tech stack
      TypeScript
      React
      Next.js
      shadcn UI
    Use cases
      AI agent dashboards
      Tool call viewers
      Approval interfaces
    Audience
      React developers
      AI app builders
    Setup
      npm install
      Next.js example included

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Show users which AI tools are being called inside your AI chat or agent app.

USE CASE 2

Display live tool-call progress with streaming, approval, error, and cancel states.

USE CASE 3

Quickly prototype an AI agent dashboard using the included Next.js example app.

USE CASE 4

Render custom output content when a tool call finishes successfully.

What is it built with?

TypeScriptReactNext.jsshadcn/ui

How does it compare?

omavashia2005/ai-tool-elements000madz000/payload-test-api-route-handleradellife/zotero-skimread
Stars333
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity2/52/53/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Install via npm and import components directly, a runnable Next.js example is included for quick testing.

No license information is provided in the repository documentation.

So what is it?

This is a TypeScript package that gives developers ready-made React components for displaying AI tool cards. When an AI agent calls external services like Slack, Gmail, Notion, or Exa, developers need a way to show users what tool is being used and what it is doing. This library provides those visual cards out of the box, so developers do not have to build them from scratch. The package installs through npm. Developers import individual tool components by name, such as Slack or Gmail, or they can import the entire catalog at once. The current catalog includes over 1000 tools, each with a matched logo where one is available. Logos come from a separate icon package and only load when needed, which keeps the final application small. Each tool card is built on top of existing open source UI components from the shadcn library. A custom tool only needs an id and a name to work. Fields like description, image, and typed required or optional fields are available but not required. The cards and their definitions do not depend on any specific backend service, so they work regardless of how the developer connects to the actual tool. The library also includes a component for showing tool calls in progress. Developers pass along the current state of the AI call, such as whether arguments are still streaming, whether approval is requested, or whether the result is ready. When the call finishes successfully, the developer can render custom React content as the output. The component supports states for streaming, approval, errors, denials, and cancellation. A runnable Next.js example is included so developers can see the components in action and edit them directly. The roadmap lists plans for more components, a unified interface for major tool providers, and agent skills.

Copy-paste prompts

Prompt 1
Install the ai-tool-elements package and set up the Slack and Gmail tool cards in my React app to display when an AI agent calls those tools.
Prompt 2
Use the tool-call-in-progress component to show streaming, approval, and completion states for an AI agent calling Notion in my Next.js app.
Prompt 3
Import the full tool catalog from ai-tool-elements and build a searchable grid of all available AI tool cards with their logos.
Prompt 4
Create a custom tool card definition with just an id and name, then add a description and required fields to it using ai-tool-elements.

Frequently asked questions

What is ai-tool-elements?

A TypeScript package providing ready-made React components that display visual cards when an AI agent uses external tools like Slack, Gmail, or Notion, so developers don't have to build them from scratch.

What language is ai-tool-elements written in?

Mainly TypeScript. The stack also includes TypeScript, React, Next.js.

What license does ai-tool-elements use?

No license information is provided in the repository documentation.

How hard is ai-tool-elements to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ai-tool-elements for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.