open-index/open-npm huggingface dataset:
npm package: @spectratools/defillama-cli
Description: DefiLlama API CLI for spectra-the-bot
Author: spectra-the-bot
Latest version: 0.4.4

# @spectratools/defillama-cli

Query DefiLlama API data from the command line — TVL, volume, fees, and token prices.

## Install

```bash
pnpm add -g @spectratools/defillama-cli
```

## LLM / Agent Discovery

```bash
# Emit machine-readable command metadata
defillama-cli --llms

# Register as a reusable local skill for agent runtimes
defillama-cli skills add

# Register as an MCP server entry
defillama-cli mcp add
```

## Quick Start

No API key required — DefiLlama is a free, public API.

```bash
# Top 10 protocols by TVL
defillama-cli tvl protocols --limit 10

# Top chains by TVL
defillama-cli tvl chains --limit 10

# Protocol detail with chain breakdown
defillama-cli tvl protocol aave

# TVL history for a protocol
defillama-cli tvl history aave --days 7

# Top DEXes by 24h volume
defillama-cli volume dexs --limit 10

# Volume for a specific DEX
defillama-cli volume protocol uniswap

# DEX aggregators ranked by volume
defillama-cli volume aggregators --limit 10

# Top protocols by fees
defillama-cli fees overview --limit 10

# Fee detail for a protocol
defillama-cli fees protocol aave

# Current token price
defillama-cli prices current ethereum:0xdAC17F958D2ee523a2206206994597C13D831ec7

# Historical token price
defillama-cli prices historical ethereum:0xdAC17F958D2ee523a2206206994597C13D831ec7 --date 2025-01-01

# Price chart
defillama-cli prices chart ethereum:0xdAC17F958D2ee523a2206206994597C13D831ec7 --start 2025-01-01 --period 1d
```

## Command Groups

| Group | Description |
|-------|-------------|
| `tvl` | Total value locked — protocols, chains, protocol detail, history |
| `volume` | DEX trading volume — dexs, protocol detail, aggregators |
| `fees` | Protocol fees and revenue — overview, protocol detail |
| `prices` | Token prices — current, historical, chart |

## Chain Filtering

Several commands support `--chain` to filter by blockchain:

```bash
defillama-cli tvl protocols --chain ethereum --limit 10
defillama-cli volume dexs --chain abstract --limit 10
defillama-cli fees overview --chain base --limit 10
```

## Output Modes

```bash
# Human-readable table output (default)
defillama-cli tvl protocols --limit 5

# JSON output for pipelines
defillama-cli tvl protocols --limit 5 --json
```

## Documentation

Full documentation: [spectratools.dev/defillama](https://spectratools.dev/defillama/)

## License

MIT
npm package: @spectre-ui/core
Description: FUI React Component Framework - Core components
Latest version: 1.0.1

# @spectre-ui/core

Core component library for **spectre-ui** — 35+ futuristic React components with HUD aesthetics, Radix UI accessibility, and Framer Motion animations.

## Installation

```bash
pnpm add @spectre-ui/core framer-motion
```

```bash
npm install @spectre-ui/core framer-motion
```

```bash
yarn add @spectre-ui/core framer-motion
```

## Quick Start

Import the CSS, wrap your app in `SpectreThemeProvider`, and start using components:

```tsx
import "@spectre-ui/core/styles.css";

import { SpectreThemeProvider, Button } from "@spectre-ui/core";

function App() {
  return (
    <SpectreThemeProvider>
      <Button variant="primary">Launch System</Button>
    </SpectreThemeProvider>
  );
}
```

## Components

### Layout

Container, Grid, Stack, Separator

### Navigation

Navbar, Sidebar, Breadcrumb, Tabs

### Data Display

Card, DataTable, Table, Badge, Avatar, Stat, Timeline, Tooltip, Popover

### Forms

Button, Input, Textarea, Select, Checkbox, Switch, Slider, Form

### Feedback

Alert, Dialog, Toast, Progress, Skeleton, DropdownMenu, CommandPalette

### Decorative

GlowBorder, GridBackground, ScanBeam, ScanlineOverlay, SystemTicker, TerminalText

## Peer Dependencies

| Package | Version |
|---------|---------|
| `react` | `^18 \|\| ^19` |
| `react-dom` | `^18 \|\| ^19` |
| `framer-motion` | `^11 \|\| ^12` (optional) |
| `tailwindcss` | `^3.4.0` |

## Documentation

Full documentation, examples, and theming guides are available at [spectreui.dev](https://spectreui.dev).

Source code is on [GitHub](https://github.com/apitlekays/spectre-ui).

## License

MIT
npm package: @spectre-ui/hooks
Description: Utility hooks for spectre-ui
Latest version: 1.0.1

# @spectre-ui/hooks

Utility React hooks for **spectre-ui** — 9 hooks for clipboard, media queries, keyboard shortcuts, scroll lock, and more.

## Installation

```bash
pnpm add @spectre-ui/hooks
```

```bash
npm install @spectre-ui/hooks
```

```bash
yarn add @spectre-ui/hooks
```

## Available Hooks

| Hook | Description |
|------|-------------|
| `useMediaQuery` | Subscribe to a CSS media query and get a boolean match result |
| `useClickOutside` | Detect clicks outside a referenced element |
| `useScrollLock` | Lock and unlock body scroll programmatically |
| `useClipboard` | Copy text to the clipboard with a copied-state timeout |
| `useLocalStorage` | Read and write values to localStorage with React state sync |
| `useKeyboardShortcut` | Bind global keyboard shortcuts with modifier key support |
| `useReducedMotion` | Detect the user's `prefers-reduced-motion` system setting |
| `useIsMounted` | Track whether a component is currently mounted |
| `useDebounce` | Debounce a rapidly changing value by a given delay |

## Quick Example

```tsx
import { useClipboard } from "@spectre-ui/hooks";

function CopyButton({ text }: { text: string }) {
  const { copy, hasCopied } = useClipboard();

  return (
    <button onClick={() => copy(text)}>
      {hasCopied ? "Copied" : "Copy"}
    </button>
  );
}
```

## Note

`useSpectreTheme` lives in `@spectre-ui/core`, not this package. Import it from there when working with theme tokens.

## Peer Dependencies

| Package | Version |
|---------|---------|
| `react` | `^18 \|\| ^19` |
| `react-dom` | `^18 \|\| ^19` |

## Documentation

Full documentation, examples, and API references are available at [spectreui.dev](https://spectreui.dev).

Source code is on [GitHub](https://github.com/apitlekays/spectre-ui).

## License

MIT
npm package: @spectre-ui/mcp
Description: MCP server for spectre-ui — gives AI coding assistants access to full framework documentation
Latest version: 1.0.1

# @spectre-ui/mcp

MCP (Model Context Protocol) server for **spectre-ui** — gives AI coding assistants full access to framework documentation, component APIs, hook references, design tokens, and prompt templates.

## What it does

When connected to an AI assistant (Claude Code, Cursor, Claude Desktop, etc.), this MCP server exposes:

- **59 resources** — component docs, hook docs, guides, design system data, and more
- **7 prompt templates** — pre-built prompts for building dashboards, landing pages, forms, etc.

## Configuration

### Claude Code

Add to `.mcp.json` in your project root:

```json
{
  "mcpServers": {
    "spectre-ui": {
      "command": "npx",
      "args": ["-y", "@spectre-ui/mcp"]
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "spectre-ui": {
      "command": "npx",
      "args": ["-y", "@spectre-ui/mcp"]
    }
  }
}
```

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "spectre-ui": {
      "command": "npx",
      "args": ["-y", "@spectre-ui/mcp"]
    }
  }
}
```

## Available Resources

| URI | Type | Description |
|-----|------|-------------|
| `spectre://overview` | Markdown | Framework overview, packages, quick start |
| `spectre://components` | JSON | Index of all 38 components |
| `spectre://hooks` | JSON | Index of all 10 hooks |
| `spectre://component/{name}` | Markdown | Full docs for a component (38 available) |
| `spectre://hook/{name}` | Markdown | Full docs for a hook (10 available) |
| `spectre://guides/getting-started` | Markdown | Getting started guide |
| `spectre://guides/installation` | Markdown | Installation instructions |
| `spectre://guides/theming` | Markdown | Theming system guide |
| `spectre://guides/design-brief` | Markdown | Design principles and aesthetic |
| `spectre://design-system/tokens` | JSON | All CSS custom properties with dark/light values |
| `spectre://design-system/tailwind-theme` | JSON | Tailwind theme extensions |
| `spectre://design-system/utilities` | JSON | Utility class definitions |
| `spectre://design-system/colors` | JSON | Full color palettes for both themes |

## Available Prompts

| Prompt | Description |
|--------|-------------|
| `build-dashboard` | Build a monitoring/analytics dashboard |
| `build-landing-page` | Build a futuristic landing page |
| `build-form` | Build a form with validation |
| `build-data-view` | Build a data display page |
| `setup-project` | Set up a new project from scratch |
| `build-navigation` | Build navigation with navbar/sidebar |
| `add-theme-switching` | Add dark/light theme switching |

## Development

```bash
# Install dependencies
pnpm install

# Run tests
pnpm --filter @spectre-ui/mcp test

# Build
pnpm --filter @spectre-ui/mcp build

# Run locally
node packages/mcp/dist/server.js
```

## License

MIT
npm package: @spectre-ui/tailwind-config
Description: Shared Tailwind CSS config and plugin for spectre-ui
Latest version: 1.0.1

# @spectre-ui/tailwind-config

Shared Tailwind CSS plugin and preset for **spectre-ui** — adds HUD corners, grid backgrounds, scanline effects, and glow utilities.

## Installation

```bash
pnpm add @spectre-ui/tailwind-config
```

```bash
npm install @spectre-ui/tailwind-config
```

```bash
yarn add @spectre-ui/tailwind-config
```

## Usage

Add the plugin to your `tailwind.config.js`:

```js
import { spectrePlugin } from "@spectre-ui/tailwind-config";

export default {
  content: ["./src/**/*.{js,ts,jsx,tsx}"],
  plugins: [spectrePlugin],
};
```

## Utility Classes

| Class | Description |
|-------|-------------|
| `.spectre-hud-corners` | Clipped corner borders in HUD style |
| `.spectre-hud-corners-full` | Full-size clipped corner borders |
| `.spectre-grid-bg` | Futuristic grid background pattern |
| `.spectre-grid-bg-sm` | Smaller grid background pattern |
| `.spectre-scanline` | Animated scanline overlay effect |
| `.spectre-glow` | Default glow box shadow |
| `.spectre-glow-sm` | Small glow box shadow |
| `.spectre-glow-lg` | Large glow box shadow |

## Theme Extensions

The plugin also extends the default Tailwind theme with:

- **Colors** — mapped to CSS custom properties set by the spectre-ui theme system
- **Fonts** — `sans` (Geist Sans), `mono` (Geist Mono / JetBrains Mono)
- **Keyframes and animations** — used by decorative components like ScanBeam and SystemTicker

## Documentation

Full documentation and utility references are available at [spectreui.dev](https://spectreui.dev).

Source code is on [GitHub](https://github.com/apitlekays/spectre-ui).

## License

MIT
npm package: @spectre-ui/themes
Description: Theme presets for spectre-ui
Latest version: 1.0.1

# @spectre-ui/themes

Theme presets for **spectre-ui** — pre-built dark and light themes with the cyber-futuristic aesthetic.

## Installation

```bash
pnpm add @spectre-ui/themes
```

```bash
npm install @spectre-ui/themes
```

```bash
yarn add @spectre-ui/themes
```

## Available Themes

| Theme | Background | Primary | Description |
|-------|-----------|---------|-------------|
| `cyber-dark` | `#020617` | `#0ea5e9` (cyan) | Dark HUD aesthetic with cyan accents |
| `cyber-light` | `#f8fafc` | `#0284c7` (blue) | Light interface with blue accents |

Each theme includes 17 color tokens, font families, and glow effect definitions.

## Usage

```tsx
import { SpectreThemeProvider } from "@spectre-ui/core";
import { cyberDark, cyberLight } from "@spectre-ui/themes";

function App() {
  return (
    <SpectreThemeProvider customTokens={cyberDark}>
      {/* Your app */}
    </SpectreThemeProvider>
  );
}
```

## Documentation

Full theming guide, token references, and customization examples are available at [spectreui.dev/docs/theming](https://spectreui.dev/docs/theming).

Source code is on [GitHub](https://github.com/apitlekays/spectre-ui).

## License

MIT