Local Build

Build typemux-cc from source using Rust and Cargo. This method is required for:

Intel macOS users (prebuilt binaries are arm64 only)
Windows users (via WSL2)
Offline environments
Development and testing

Prerequisites

Required Tools

Install Rust

typemux-cc requires Rust 1.75 or later.

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Verify installation:

rustc --version
cargo --version

The installation script will update your shell profile. Restart your terminal or run:

source $HOME/.cargo/env

Install Git

Required for cloning the repository.

# Git is pre-installed on macOS
git --version

Install LSP Backend

Install at least one Python type-checker backend:

npm install -g pyright

Build from Source

1. Clone Repository

git clone https://github.com/K-dash/typemux-cc.git
cd typemux-cc

2. Build Binary

Choose a build type:

Release Build (Recommended)
Debug Build

Optimized binary for production use:

cargo build --release

Or using the Makefile:

make release

The binary will be at ./target/release/typemux-cc

Release builds are optimized with LTO (Link-Time Optimization) and symbol stripping for smaller binary size.

Faster compilation for development:

cargo build

Or using the Makefile:

make build

The binary will be at ./target/debug/typemux-cc

Debug builds are significantly larger and slower than release builds. Use only for development.

3. Test Binary

Run the binary directly to verify it works:

# Release build
./target/release/typemux-cc --version

# Debug build
./target/debug/typemux-cc --version

Expected output: typemux-cc 0.2.3 (or current version)

Install as Claude Code Plugin

Method 1: Install from Local Directory (Recommended)

Disable Official pyright Plugin

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

Add Local Marketplace

Point to your local build directory:

/plugin marketplace add /path/to/typemux-cc

Use the absolute path to your cloned repository. Claude Code will use the built binary from ./target/release/ or ./target/debug/.

Install Plugin

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

Restart Claude Code

Restart Claude Code to load the plugin.

Method 2: Manual Installation

Create Plugin Directory

mkdir -p ~/.claude/plugins/typemux-cc/bin

Copy Binary and Files

# Copy binary
cp target/release/typemux-cc ~/.claude/plugins/typemux-cc/bin/

# Copy wrapper script
cp bin/typemux-cc-wrapper.sh ~/.claude/plugins/typemux-cc/bin/
chmod +x ~/.claude/plugins/typemux-cc/bin/typemux-cc-wrapper.sh

# Copy plugin metadata
cp -r .claude-plugin ~/.claude/plugins/typemux-cc/

Update Plugin Path

Edit ~/.claude/plugins/typemux-cc/.claude-plugin/plugin.json:

{
  "lspServers": {
    "typemux-cc": {
      "command": "${HOME}/.claude/plugins/typemux-cc/bin/typemux-cc-wrapper.sh",
      "args": []
    }
  }
}

Enable Plugin

Add to ~/.claude/settings.json:

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

Restart Claude Code

Restart Claude Code to load the plugin.

Development Setup

For active development on typemux-cc:

Quality Checks

The Makefile provides targets for all quality checks:

make fmt

# Check formatting (CI mode)
make fmt-check

Cargo.toml Configuration

Cargo.toml

[package]
name = "typemux-cc"
version = "0.2.3"
edition = "2021"
rust-version = "1.75"

[dependencies]
tokio = { version = "1.43", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
lsp-types = "0.97"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
tracing-appender = "0.2"
thiserror = "2.0"
anyhow = "1.0"
bytes = "1.9"
url = "2.5"
clap = { version = "4.5", features = ["derive", "env"] }

[profile.release]
lto = true
strip = true

Key features:

LTO (Link-Time Optimization): Aggressive optimization for smaller binaries
Symbol stripping: Removes debug symbols from release builds
clap: CLI argument parsing with environment variable support

Running Tests

# Run all tests
cargo test

# Run specific test
cargo test test_find_venv

# Run with output
cargo test -- --nocapture

# Run with debug logging
RUST_LOG=debug cargo test

Running Locally

Test the binary without installing:

./target/release/typemux-cc

Command-Line Options

All options from src/main.rs:

src/main.rs (excerpt)

#[derive(Parser, Debug)]
#[command(author, version, about, long_about = None)]
struct Args {
    /// Optional path to log file (default: stderr only)
    #[arg(long, env = "TYPEMUX_CC_LOG_FILE")]
    log_file: Option<PathBuf>,

    /// Maximum number of concurrent backend processes (default: 8, minimum: 1)
    #[arg(long, env = "TYPEMUX_CC_MAX_BACKENDS", default_value = "8")]
    max_backends: u64,

    /// Backend TTL in seconds (default: 1800 = 30 minutes). Set to 0 to disable.
    #[arg(long, env = "TYPEMUX_CC_BACKEND_TTL", default_value = "1800")]
    backend_ttl: u64,

    /// LSP backend to use: pyright, ty, or pyrefly
    #[arg(long, env = "TYPEMUX_CC_BACKEND", default_value = "pyright")]
    backend: BackendKind,
}

Backend Commands

How each backend is spawned (from src/backend.rs):

src/backend.rs (excerpt)

impl BackendKind {
    fn command(&self) -> &'static str {
        match self {
            Self::Pyright => "pyright-langserver",
            Self::Ty => "ty",
            Self::Pyrefly => "pyrefly",
        }
    }

    fn args(&self) -> &'static [&'static str] {
        match self {
            Self::Pyright => &["--stdio"],
            Self::Ty => &["server"],
            Self::Pyrefly => &["lsp"],
        }
    }
}

Troubleshooting

Rust version too old

Error:

error: package requires rustc 1.75 or newer

Solution:

# Update Rust to latest stable
rustup update stable

# Verify version
rustc --version

Linker errors on Linux

Error:

error: linker `cc` not found

Solution:

# Ubuntu/Debian
sudo apt-get install build-essential

# Fedora/RHEL
sudo dnf groupinstall "Development Tools"

Compilation fails with missing dependencies

Error:

error: failed to resolve patches for `...`

Solution:

# Clean and rebuild
cargo clean
cargo build --release

Binary runs but LSP doesn't work

Check:

Backend is installed:
```
which pyright-langserver
```

Binary has execute permission:

chmod +x ~/.claude/plugins/typemux-cc/bin/typemux-cc

Plugin is enabled in ~/.claude/settings.json
Test binary directly:
```
./target/release/typemux-cc --version
```

Tests fail

Common causes:

Git not installed (required for venv tests)
Temporary directory permissions
Tokio runtime issues

Solution:

# Run tests with verbose output
cargo test -- --nocapture

# Skip specific tests
cargo test --exclude-test test_name

Continuous Integration

The CI pipeline runs on GitHub Actions:

.github/workflows/ci.yml

name: CI

on:
  push:
    branches: [main]
  pull_request:

jobs:
  ci:
    name: Makefile CI (${{ matrix.os }})
    runs-on: ${{ matrix.os }}
    strategy:
      matrix:
        os:
          - ubuntu-latest
          - macos-latest
          - ubuntu-24.04-arm
    steps:
      - uses: actions/checkout@v5
      - uses: dtolnay/rust-toolchain@stable
      - uses: Swatinem/rust-cache@v2
      - run: make ci

The pipeline ensures:

✅ Code formatting (cargo fmt --check)
✅ No clippy warnings (cargo clippy -- -D warnings)
✅ All tests pass (cargo test)
✅ Cross-platform compatibility (Linux, macOS, arm64)

Update Local Build

To update your local build to the latest version:

cd /path/to/typemux-cc

# Pull latest changes
git pull origin main

# Rebuild
cargo build --release

# Reinstall (if using Method 1)
/plugin update typemux-cc@typemux-cc-marketplace

Get Started

Installation

Usage

Configuration

Advanced

Troubleshooting

Prerequisites

Required Tools

Build from Source

1. Clone Repository

2. Build Binary

3. Test Binary

Install as Claude Code Plugin

Method 1: Install from Local Directory (Recommended)

Method 2: Manual Installation

Development Setup

Quality Checks

Cargo.toml Configuration

Running Tests

Running Locally

Command-Line Options

Backend Commands

Troubleshooting

Continuous Integration

Update Local Build

Next Steps

Configuration

Architecture

Get Started

Installation

Usage

Configuration

Advanced

Troubleshooting

​Prerequisites

​Required Tools

​Build from Source

​1. Clone Repository

​2. Build Binary

​3. Test Binary

​Install as Claude Code Plugin

​Method 1: Install from Local Directory (Recommended)

​Method 2: Manual Installation

​Development Setup

​Quality Checks

​Cargo.toml Configuration

​Running Tests

​Running Locally

​Command-Line Options

​Backend Commands

​Troubleshooting

​Continuous Integration

​Update Local Build

​Next Steps

Configuration

Architecture

Prerequisites

Required Tools

Build from Source

1. Clone Repository

2. Build Binary

3. Test Binary

Install as Claude Code Plugin

Method 1: Install from Local Directory (Recommended)

Method 2: Manual Installation

Development Setup

Quality Checks

Cargo.toml Configuration

Running Tests

Running Locally

Command-Line Options

Backend Commands

Troubleshooting

Continuous Integration

Update Local Build

Next Steps