Marketplace Installation

Install typemux-cc from GitHub marketplace

Install typemux-cc from the GitHub marketplace using prebuilt binaries. This is the recommended installation method for most users.

Claude Code restart is required only for initial installation. After installation, .venv creation and switching no longer require restarts.

Prerequisites

Before installing from the marketplace:

1. Disable Official pyright Plugin

   You must disable the official pyright plugin to avoid conflicts.

   /plugin disable pyright-lsp@claude-plugins-official
   

   Having both typemux-cc and the official pyright plugin enabled causes conflicts. Ensure the official plugin is disabled before proceeding.

2. Install LSP Backend

   Install at least one supported backend:

   pyright (recommended)

   npm install -g pyright
   

   See Prerequisites for more details.

Installation Steps

1. Add Marketplace

   Add the typemux-cc marketplace repository:

   /plugin marketplace add K-dash/typemux-cc
   

   This registers the GitHub repository as a plugin source.

2. Install Plugin

   Install the plugin from the marketplace:

   /plugin install typemux-cc@typemux-cc-marketplace
   

   The installation script will:

   • Detect your OS and architecture
   • Download the appropriate binary from GitHub releases
   • Install to ~/.claude/plugins/cache/typemux-cc-marketplace/
   • Make the binary executable
3. Restart Claude Code

   Restart Claude Code to load the plugin.

   This restart is only needed for the initial installation. Future .venv changes do not require restarts.

Verification

After restarting Claude Code, verify the installation:

1. Check Plugin Status

Open a Python file and check for type-checking diagnostics. If you see type hints and error diagnostics, the plugin is working.

2. Verify Settings

Check ~/.claude/settings.json:

settings.json

{
  "enabledPlugins": {
    "pyright-lsp@claude-plugins-official": false,
    "typemux-cc@typemux-cc-marketplace": true
  }
}

Both entries should be present:

• Official pyright: false (disabled)
• typemux-cc: true (enabled)

3. Enable File Logging (Optional)

For detailed diagnostics, enable file logging:

mkdir -p ~/.config/typemux-cc
cat > ~/.config/typemux-cc/config << 'EOF'
# Enable file output
export TYPEMUX_CC_LOG_FILE="/tmp/typemux-cc.log"

# Set log level (optional)
export RUST_LOG="typemux_cc=debug"
EOF

Then restart Claude Code and check the logs:

tail -f /tmp/typemux-cc.log

Supported Platforms

The marketplace provides prebuilt binaries for:

Platform	Architecture	Binary Name
macOS	arm64 (Apple Silicon)	typemux-cc-macos-arm64
Linux	x86_64	typemux-cc-linux-x86_64
Linux	arm64	typemux-cc-linux-arm64

Intel macOS and Windows are not supported via marketplace. Use local build for Intel macOS.

Update Plugin

Update to the latest version:

/plugin update typemux-cc@typemux-cc-marketplace

After updating, restart Claude Code to load the new version.

Update Not Taking Effect?

Due to a known Claude Code issue, plugin updates may not refresh cached files. If the old version persists:

1. Remove Cached Plugin

   rm -rf ~/.claude/plugins/cache/typemux-cc-marketplace/
   
2. Reinstall

   /plugin install typemux-cc@typemux-cc-marketplace
   
3. Restart Claude Code

   Restart Claude Code to load the fresh installation.

Uninstall

Remove typemux-cc and re-enable the official pyright plugin:

1. Uninstall Plugin

   /plugin uninstall typemux-cc@typemux-cc-marketplace
   
2. Remove Marketplace

   /plugin marketplace remove typemux-cc-marketplace
   
3. Re-enable Official Plugin

   /plugin enable pyright-lsp@claude-plugins-official
   
4. Restart Claude Code

   Restart Claude Code to apply changes.

Troubleshooting

Installation Fails

Binary not found for your platform

Error:

ERROR: Failed to find binary for typemux-cc-[platform]

Solution:

• For Intel macOS: Build from source
• For Windows: Use WSL2 or build from source
• Check releases page for available binaries

GitHub API rate limiting

Error:

curl: (22) HTTP 403: API rate limit exceeded

Solution:

• Wait a few minutes and try again
• Authenticate with GitHub CLI: gh auth login
• Use local build instead

Download fails in offline environment

Error:

curl: (6) Could not resolve host

Solution:

• Check your network connection
• Check corporate firewall settings
• Use local build for offline environments

Permission denied when installing

Error:

Permission denied: ~/.claude/plugins/cache/

Solution:

# Fix permissions
chmod -R u+w ~/.claude/plugins/cache/

# Retry installation
/plugin install typemux-cc@typemux-cc-marketplace

LSP Not Working After Installation

No type-checking diagnostics

Check:

1. Verify backend is installed:
   which pyright-langserver  # or: which ty, which pyrefly
   
2. Check plugin is enabled in ~/.claude/settings.json
3. Verify .venv/pyvenv.cfg exists in your project
4. Enable file logging and check for errors

Backend command not found

Error in logs:

Failed to spawn backend: No such file or directory (os error 2)

Solution: Install the backend:

npm install -g pyright
# or
pip install ty
# or
pip install pyrefly

Conflicts with official pyright plugin

Symptoms:

• Duplicate diagnostics
• LSP errors
• Claude Code performance issues

Solution: Ensure official plugin is disabled:

/plugin disable pyright-lsp@claude-plugins-official

Verify in ~/.claude/settings.json:

"pyright-lsp@claude-plugins-official": false

How Marketplace Installation Works

The marketplace installation uses install.sh from the repository, which:

1. Detects Platform

   install.sh (excerpt)

   OS=$(uname -s)
   ARCH=$(uname -m)
   
   case "$OS" in
     Darwin)
       if [ "$ARCH" = "arm64" ]; then
         BINARY_NAME="typemux-cc-macos-arm64"
       else
         echo "ERROR: Intel macOS is not supported"
         exit 1
       fi
       ;;
     Linux)
       if [ "$ARCH" = "x86_64" ]; then
         BINARY_NAME="typemux-cc-linux-x86_64"
       elif [ "$ARCH" = "aarch64" ] || [ "$ARCH" = "arm64" ]; then
         BINARY_NAME="typemux-cc-linux-arm64"
       fi
       ;;
   esac
   
2. Downloads Binary

   install.sh (excerpt)

   REPO="K-dash/typemux-cc"
   LATEST_RELEASE=$(curl -s "https://api.github.com/repos/${REPO}/releases/latest")
   DOWNLOAD_URL=$(echo "$LATEST_RELEASE" | grep "browser_download_url.*${BINARY_NAME}" | cut -d '"' -f 4)
   
   curl -L -o "${BINARY_PATH}" "$DOWNLOAD_URL"
   chmod +x "${BINARY_PATH}"
   
3. Installs Wrapper

   The wrapper script loads configuration from ~/.config/typemux-cc/config:

   typemux-cc-wrapper.sh

   #!/bin/bash
   CONFIG_FILE="$HOME/.config/typemux-cc/config"
   if [ -f "$CONFIG_FILE" ]; then
     source "$CONFIG_FILE"
   fi
   
   exec "${CLAUDE_PLUGIN_ROOT}/bin/typemux-cc" "$@"
   

Next Steps

Configuration

Configure backend selection and logging

Usage Guide

Learn how to use typemux-cc