open-index/open-npm huggingface dataset:
npm package: @howells/wiredeck
Description: Agent-first CLI and MCP server for WireDeck presentation decks.
Latest version: 0.3.0

# WireDeck

WireDeck is a markdown-to-presentation toolkit with two publishable Node entrypoints:

- `wiredeck` for CLI deck management
- `wiredeck-mcp` for a stdio MCP server that exposes the same deck and slide operations

Both executables talk to the WireDeck machine API over HTTPS.

## Install

```bash
npm install -g @howells/wiredeck
```

If your global npm prefix points at a system-owned directory, install without sudo:

```bash
npm install -g @howells/wiredeck --prefix ~/.local
```

## CLI

Create a token in the WireDeck app at `/settings/tokens`, then save it locally:

```bash
wiredeck auth login --token wdk_...
wiredeck auth status
```

```bash
wiredeck --help
wiredeck list
wiredeck create q3-board-update --file ./deck.md
wiredeck get q3-board-update --metadata-only
wiredeck slide add q3-board-update 2 --file ./slide.md --layout image-right
```

The CLI is JSON-first by design so it works cleanly in shells, scripts, and agent workflows.

## MCP server

Run the stdio MCP server directly:

```bash
wiredeck-mcp
```

`wiredeck-mcp` reads the same saved auth config as the CLI. After `wiredeck auth login`, configure an MCP client to call the published bin directly:

```json
{
  "mcpServers": {
    "wiredeck": {
      "command": "wiredeck-mcp"
    }
  }
}
```

## Environment

Required:

- `WIREDECK_TOKEN` — personal access token from `/settings/tokens`

Optional:

- `WIREDECK_API_URL` — WireDeck base URL, defaults to `https://wiredeck.app`

Config precedence is:

1. CLI flags like `--api-url` and `--token`
2. Environment variables
3. `~/.wiredeck/config.json`

## Development

For local repo development:

```bash
pnpm dev
pnpm typecheck
pnpm test
pnpm e2e
pnpm build:package
```

For the published package:

```bash
npm pack
npm publish
```