# Chartbuddy Hub

> Desktop charting app. AI clients connect via local stdio MCP (`chartbuddy --mcp`), not via this docs host. Docs site ≠ MCP API (no OpenAPI).

Start here, then follow links. Do not load `llms-full.txt` by default.

Hard rules:
- Transport is **stdio** (spawn the Chartbuddy binary with `--mcp`). This host is not an MCP endpoint.
- Framing: **newline-delimited JSON-RPC** (preferred) or Content-Length.
- Prefer **user/global** MCP config — machine-specific binary paths should not be committed to repos.
- Live tools need Hub running (`open -a Chartbuddy`). `--mcp-status` is read-only and never launches Hub.
- Before wiring a client, fetch [MCP setup (markdown)](https://chartbuddy.io/hub/mcp-setup.md) and the client page `.md` you need.

## Must read

- [MCP setup (markdown)](https://chartbuddy.io/hub/mcp-setup.md): Command, args, framing, status, smoke test
- [MCP setup (JSON)](https://chartbuddy.io/hub/mcp-setup.json): `kind: mcp-client-config` connect descriptor
- [Install Hub](https://chartbuddy.io/hub/docs/getting-started/installation.md): Download, Applications, Gatekeeper
- [Connect MCP overview](https://chartbuddy.io/hub/docs/connect-mcp.md): How clients spawn Hub over stdio
- [Docs index](https://chartbuddy.io/hub/docs/llms.txt): Same curated index under `/hub/docs/`

Short paths: `/hub/llms.txt`, `/hub/mcp-setup.md`, `/hub/mcp-setup.json`

## Connect MCP

- [Overview](https://chartbuddy.io/hub/docs/connect-mcp.md): Stdio model, verify, troubleshooting
- [Cursor](https://chartbuddy.io/hub/docs/connect-mcp/cursor.md): `~/.cursor/mcp.json` (user/global) — **recommended**
- [Claude Code](https://chartbuddy.io/hub/docs/connect-mcp/claude-code.md): `claude mcp add-json` user scope; desktop **Code** tab — **recommended**
- [OpenCode](https://chartbuddy.io/hub/docs/connect-mcp/opencode.md): Global `opencode.json` `type: local` — **recommended**
- [ChatGPT / Codex](https://chartbuddy.io/hub/docs/connect-mcp/chatgpt-codex.md): Codex CLI and desktop **Codex** tab
- [ChatGPT](https://chartbuddy.io/hub/docs/connect-mcp/chatgpt.md): Browser / regular desktop chat (no Hub MCP yet; see Embed)
- [Claude](https://chartbuddy.io/hub/docs/connect-mcp/claude.md): Browser / desktop **Home** tab (no Hub MCP yet; see Embed)

## Getting Started

- [Introduction](https://chartbuddy.io/hub/docs/getting-started.md): What Hub is and where to start
- [Install Hub](https://chartbuddy.io/hub/docs/getting-started/installation.md): macOS install path

## Guides

- [Overview](https://chartbuddy.io/hub/docs/guides.md): Workflow guide index
- [Desktop basics](https://chartbuddy.io/hub/docs/guides/desktop-basics.md): First launch, editing, exporting
- [Push & pull](https://chartbuddy.io/hub/docs/guides/push-and-pull.md): Move charts between Hub and other surfaces
- [From Chrome extension](https://chartbuddy.io/hub/docs/guides/from-chrome-extension.md): What carries over from the Slides extension

## Optional

- [Full docs bundle](https://chartbuddy.io/hub/docs/llms-full.txt): Entire Hub docs site in one file — skip unless you need a single blob
- [Embed docs index](https://unpkg.com/@chartbuddy.io/embed/llms.txt): HTML charts via `new Insight()` (separate from Hub MCP)