Install the CLI

The Noddle Deck CLI is a Python package that runs on macOS, Linux, and WSL. Pick the install method that fits your existing Python tooling.

Requirements

Python 3.8 or newer
macOS, Linux, or Windows Subsystem for Linux (WSL)
A Noddle Deck account (sign up free)

pipx (recommended)

Pipx isolates the CLI in its own virtualenv so it never clashes with your project deps.

bash

brew install pipx        # macOS
# or: python -m pip install --user pipx

pipx install noddle-deck-cli

pip

Standard pip works fine if you don't care about isolation.

bash

python -m pip install --user noddle-deck-cli

uv

If you use uv for everything Python, install the CLI as a tool.

bash

uv tool install noddle-deck-cli

Verify the install

bash

noddle-deck --version

You should see the version number. If your shell can't find noddle-deck, your install method didn't add it to PATH — run pipx ensurepath (or the equivalent for your method) and reopen the terminal.

Upgrade

bash

noddle-deck update                  # checks PyPI for a newer release
pipx upgrade noddle-deck-cli        # apply

noddle-deck update only reports the gap — it never invokes pip itself, so it stays neutral about your install method.

Uninstall

bash

pipx uninstall noddle-deck-cli       # if installed with pipx
pip uninstall noddle-deck-cli        # if installed with pip

Local synced content under ~/.claude/skills/noddle-deck-* and ~/.claude/commands/noddle-deck-* is not removed automatically — delete those folders if you want a clean slate.