# Pointcast

Turns browser clicks and microphone notes into Markdown specs for coding agents. Helps supply exact component file paths when explaining frontend bugs.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: Hugelidus
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Hugelidus/Pointcast/tree/HEAD/packages/cli
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/pointcast

## What it does

The tool bridges a Chrome extension and local coding agents. You click around a React or Vue development build while describing changes out loud. Pointcast captures the component hierarchy, tracks matching text in your project files, and notes the precise line numbers inside the generated report.

Agent sessions read the recording data over stdio MCP without modifying your local history. A local listener on 127.0.0.1 receives recordings directly from the browser, skipping the downloads folder. For accurate path resolution in monorepos, launch the tool from the repository root.

Node.js 22.12 or newer is mandatory. The Chrome extension handles speech recognition directly in the browser, so local transcription engines are omitted by default. If you force local Whisper processing with `@huggingface/transformers`, expect an initial download of around 450 MB.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `POINTCAST_DIR`, `POINTCAST_HANDOFF` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env POINTCAST_DIR=<POINTCAST_DIR> --env POINTCAST_HANDOFF=<POINTCAST_HANDOFF> --transport stdio cli -- npx -y pointcast
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add cli --env POINTCAST_DIR=<POINTCAST_DIR> --env POINTCAST_HANDOFF=<POINTCAST_HANDOFF> -- npx -y pointcast
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cli": {
            "command": "npx",
            "args": [
                "-y",
                "pointcast"
            ],
            "env": {
                "POINTCAST_DIR": "<POINTCAST_DIR>",
                "POINTCAST_HANDOFF": "<POINTCAST_HANDOFF>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cli": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "pointcast"
            ],
            "env": {
                "POINTCAST_DIR": "<POINTCAST_DIR>",
                "POINTCAST_HANDOFF": "<POINTCAST_HANDOFF>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e POINTCAST_DIR=<POINTCAST_DIR> -e POINTCAST_HANDOFF=<POINTCAST_HANDOFF> cli npx -y pointcast
```
Replace <…> with your own values

## When to use it
- trace clicked UI elements back to source code lines
- convert voice recordings from the browser into Markdown specs
- stream interface recordings into coding agents via stdio MCP
- publish recorded inspection sessions as GitHub issues

## Example prompts
- Read the latest Pointcast session and fix the export button styling
- Inspect the recent Pointcast recording to update the table component

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
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