cc-switch 0.1.39

Switch between multiple Claude / Codex configurations. Optional daemon proxies traffic to a built-in dashboard — requests, conversations, token stats. Cross-platform.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

//! Daemon subsystem: in-process supervision of one ccs-proxy per upstream URL.
//!
//! See docs/superpowers/specs/2026-05-28-cc-switch-daemon-design.md for design.

pub mod aggregate;
pub mod commands;
pub mod pidfile;
pub mod state;
pub mod status;

#[cfg(unix)]
pub mod fork;
#[cfg(unix)]
pub mod lifecycle;
#[cfg(unix)]
pub mod logging;

pub use commands::{DaemonAction, handle_daemon_command};

use crate::daemon::pidfile::{Pidfile, process_alive};
use crate::daemon::state::{CURRENT_VERSION, DaemonState};

/// If the daemon is alive but was started by a `cc-switch` binary whose version
/// differs from this one, return a warning message. Returns `None` when the
/// daemon is stopped or its version matches the current binary.
///
/// A stale daemon may expose different proxy/api ports or capture semantics, so
/// the user should restart it after upgrading `cc-switch`.
pub fn version_mismatch_warning() -> Option<String> {
    let home = dirs::home_dir()?;
    let cc_switch_dir = home.join(".cc-switch");
    let state = DaemonState::load(&cc_switch_dir.join("daemon-state.json")).ok()??;

    // Only warn when a daemon is actually running.
    let pidfile = Pidfile::new(cc_switch_dir.join("daemon.pid"));
    let pid = pidfile.read().ok()??;
    if !matches!(process_alive(pid), Ok(true)) {
        return None;
    }

    if !state.version_mismatch() {
        return None;
    }

    let running = if state.version.is_empty() {
        "unknown (pre-version)".to_string()
    } else {
        state.version.clone()
    };
    Some(format!(
        "cc daemon is running an outdated version (daemon {running}, CLI {CURRENT_VERSION}) — proxy ports/capture may be stale. Run `cc-switch daemon restart`."
    ))
}

/// Print the version-mismatch warning in red, if one applies. No-op otherwise.
pub fn print_version_mismatch_warning() {
    use colored::Colorize;
    if let Some(msg) = version_mismatch_warning() {
        eprintln!("{}", format!("\u{26a0} {msg}").red().bold());
    }
}

/// Result of attempting to resolve a proxy URL for a given upstream.
pub enum ProxyResolution {
    /// Daemon is running and has a matching proxy.
    Proxied { proxy_url: String },
    /// Daemon is not running or has no match; use direct URL.
    Direct,
}

/// Check whether the daemon is alive and has a proxy for the given upstream URL.
/// Returns the proxy URL (http://127.0.0.1:<port>) if available, otherwise Direct.
pub fn try_resolve_proxy(upstream: &str) -> ProxyResolution {
    let home = match dirs::home_dir() {
        Some(h) => h,
        None => return ProxyResolution::Direct,
    };
    let cc_switch_dir = home.join(".cc-switch");
    let state_path = cc_switch_dir.join("daemon-state.json");
    let pidfile_path = cc_switch_dir.join("daemon.pid");

    try_resolve_proxy_from_paths(upstream, &state_path, &pidfile_path)
}

fn try_resolve_proxy_from_paths(
    upstream: &str,
    state_path: &std::path::Path,
    pidfile_path: &std::path::Path,
) -> ProxyResolution {
    let state = match DaemonState::load(state_path) {
        Ok(Some(s)) => s,
        _ => return ProxyResolution::Direct,
    };

    let pidfile = Pidfile::new(pidfile_path.to_path_buf());
    let pid = match pidfile.read() {
        Ok(Some(pid)) => pid,
        _ => return ProxyResolution::Direct,
    };

    match process_alive(pid) {
        Ok(true) => {}
        _ => return ProxyResolution::Direct,
    }

    match state.find_proxy("claude", upstream) {
        Some(entry) => ProxyResolution::Proxied {
            proxy_url: format!("http://127.0.0.1:{}", entry.proxy_port),
        },
        None => ProxyResolution::Direct,
    }
}