# crucix-intelligence-dashboard

A skill that walks your agent through setting up Crucix: a self-hosted terminal with 27 open data feeds, Telegram and Discord bots, and LLM-written analysis.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1400 installs · ★ 88
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/crucix-intelligence-dashboard/SKILL.md
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/skills/crucix-intelligence-dashboard

## What it does

The skill takes the agent through a Crucix install: clone the repo, pull dependencies, fill `.env` with source keys, start the server on `http://localhost:3117`. Every 15 minutes the project queries 27 open feeds, including satellite fire detections, flight tracking, radiation, conflict events, market prices and maritime AIS, then draws them on a WebGL globe. Alerts land in Telegram or Discord and an LLM writes the analysis.

Node.js 22+ is the only hard requirement, since the code relies on native `fetch` and ESM. Keys for FRED, FIRMS and EIA widen coverage considerably; everything else is optional. Pick a provider in `LLM_PROVIDER` — anthropic, openai, gemini or codex. The codex route skips the API key but needs a one-time `npx @openai/codex login`. LLM trouble is not fatal: alert scoring falls back to rules and the sweep keeps running.

Discord has two modes. With `discord.js` installed you get slash commands and rich embeds. Without it Crucix only posts through `DISCORD_WEBHOOK_URL`. If `npm run dev` exits without a word, run `node server.mjs` directly, or run `node diag.mjs` to check the Node version, imports and port availability.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill crucix-intelligence-dashboard -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/crucix-intelligence-dashboard/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/crucix-intelligence-dashboard/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill crucix-intelligence-dashboard -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/crucix-intelligence-dashboard/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill crucix-intelligence-dashboard -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/crucix-intelligence-dashboard/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills crucix-intelligence-dashboard
```

2. **Manually: put the files in place**
- File: `.github/skills/crucix-intelligence-dashboard/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill crucix-intelligence-dashboard -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/crucix-intelligence-dashboard
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/crucix-intelligence-dashboard/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill crucix-intelligence-dashboard -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/crucix-intelligence-dashboard/SKILL.md

## When to use it
- run a local OSINT dashboard with a 3D globe
- push Telegram alerts for events that cross a threshold
- watch many public feeds in one place
- hook an LLM up to the delta between sweeps
- use Discord webhook alerts without a full bot

## Example prompts
- Set up Crucix from the skill and bring the dashboard up at `http://localhost:3117`
- Put `FIRMS_MAP_KEY` and `FRED_API_KEY` into `.env`, then start it with `npm run dev`
- Wire the Telegram bot with `TELEGRAM_BOT_TOKEN` and `TELEGRAM_CHAT_ID`, then check `/status`

## Similar
- [claude-to-im](https://affpapa.org/en/nevibecode/skills/claude-to-im.md) — skill · 7100 installs
- [chat-sdk](https://affpapa.org/en/nevibecode/skills/vercel-chat-sdk.md) — skill · 5400 installs
- [configure-notifications](https://affpapa.org/en/nevibecode/skills/configure-notifications.md) — skill · 785 installs
- [metrics-dashboard](https://affpapa.org/en/nevibecode/skills/metrics-dashboard.md) — skill · 3000 installs
- [build-dashboard](https://affpapa.org/en/nevibecode/skills/build-dashboard.md) — skill · 8 installs
- [kpi-dashboard-design](https://affpapa.org/en/nevibecode/skills/kpi-dashboard-design.md) — skill · 16141 installs

From the same set: [reason-machines/trending-skills](https://affpapa.org/en/nevibecode/by/reason-machines/trending-skills.md) — 186 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md