23J1633

A2Switch — Development skill for Claude Code

Development community

A2S desktop control center for one-click Agent bridge installation, shared device configuration, process control, and remote pairing.

How to install A2Switch

This entry records only its repository, not the path inside it, so there is no exact command to give. Open 23J1633/A2Switch and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What A2Switch does

A2S desktop control center for one-click Agent bridge installation, shared device configuration, process control, and remote pairing.

Alternatives in Development

ClaudeCode Portable — Run Claude Code from a USB drive on any PC — no installation required 1.4k ★
Nexting — Remote control for Claude Code, Codex, Grok, and Cursor on Mac or PC 1.3k ★
Gmail AutoAuth MCP Installation Guide — This guide will help you install and configure the Gmail AutoAuth MCP server for managing Gmail operations thr 1.1k ★

README

[中文](#中文) | [English](#english)

A2Switch

中文

A2S 生态（同系列开源仓库）

A2S 按组件拆分为以下同系列仓库，所有者均为 `23J1633`。/ A2S is split into the following sibling repositories, all owned by `23J1633`.

仓库 / Repository	作用 / Role	GitHub
A2Switch	Windows 桌面控制中心 / Windows desktop control center	23J1633/A2Switch
cc2server	Claude Code 桥接器 / Claude Code bridge	23J1633/cc2server
codex2server	Codex 桥接器 / Codex bridge	23J1633/codex2server
dsh2server	DeepSeek Harness 插件 / DeepSeek Harness plugin	23J1633/dsh2server
server-api	中转服务与 Web 控制台 / relay server and Web console	23J1633/server-api
a2s_app	Flutter Android 客户端 / Flutter Android client	23J1633/a2s_app

A2Switch 是 A2S 的本机桌面控制中心。它使用 Electron 实现，界面布局参考 CC Switch，但数据模型与操作面向 Claude Code、Codex、DeepSeek Harness 三种 Agent。

它负责四件事：

创建和维护一份跨桥接器共享的设备配置与设备 key；
检测本机 Agent 环境，统一展示本机进程与服务器在线状态；
启动、停止、重启 cc2server 与 codex2server，并在不终止 Harness 宿主的前提下启停/重连 dsh2server；
从内置或远程插件目录一键安装/更新三个桥接器。

运行

要求 Node.js 22+。开发环境：

cd D:\Project\A2S\A2Switch
npm install
npm start

诊断本机 Agent：

npm run doctor
npm run icon

生成未安装目录包或 Windows 安装包：

npm run pack
npm run dist

`pack` 输出可直接运行的目录；`dist` 同时生成 `A2Switch-Setup--.exe` 与 `A2Switch-Portable--.exe`。 `icon` 校验项目方提供的白底方形 PNG 是否能用于 Windows 打包；它不会重新绘制或覆盖原始素材。

页面与操作

总览

展示服务器健康状态、同设备下三个 Agent 的在线状态、桥接进程 PID 与插件版本。
顶部标签可快速聚焦 Claude、Codex 或 DSH。
状态同时参考 A2Switch 管理的子进程、桥接器写入的 runtime 文件和 server-api 返回的实例列表。
能识别并接管从已安装目录手工启动的 Claude/Codex 桥接进程，避免自动启动时产生重复实例。
Windows 独立部署会优先识别 D:\dsh\dsh.cmd 启动包装器，确保插件注册使用实际 DSH_HOME，不会误装进用户目录下的另一个空 profile。
DSH 卡片提供“重启/停止”；停止只关闭服务器桥接，Ha