Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/K-dash/typemux-cc/llms.txt

Use this file to discover all available pages before exploring further.

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:
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:
PlatformArchitectureBinary Name
macOSarm64 (Apple Silicon)typemux-cc-macos-arm64
Linuxx86_64typemux-cc-linux-x86_64
Linuxarm64typemux-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

Error:
ERROR: Failed to find binary for typemux-cc-[platform]
Solution:
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
Error:
curl: (6) Could not resolve host
Solution:
  • Check your network connection
  • Check corporate firewall settings
  • Use local build for offline environments
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

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
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
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

Build docs developers (and LLMs) love

Get started for freeTalk to us