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

npm install -g @howells/wiredeck

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

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

CLI

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

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

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:

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:

{
  "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:

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

For the published package:

npm pack
npm publish