← 返回列表
AI 编程AI 资源

mystical-assistant:本地 Claude Code 多会话仪表盘与远程控制

ainurdev/mystical-assistant · You're running six Claude Code sessions and you can see one. A local dashboard for every session on your machine — including the ones you started in VS Code or a terminal — grouped by repo, marked alive or not, and answerable from your desk or your phone. Parks turns a usage limit kills and carries them on. Python stdlib only, no API key.

GitHub原文发布 未知首次收录 2026-10-09上架 2026-10-09 07:03

☆ 收藏查看项目 ↗

ELI5:它是什么,解决什么问题

mystical-assistant 是一个在本地运行的仪表盘,用于汇总机器上所有 Claude Code 会话——包括在 VS Code 或终端中启动的会话——按仓库分组并标记存活状态,可从桌面或手机进行应答与继续。当触发用量上限时,它会暂存会话并尝试通过其它 Claude 账户、不同供应商的免费 agent 或等待重置时间继续执行。桥接层在本地调用 claude 并复用其登录状态,因此无需 API 密钥。服务端仅使用 Python 标准库,无第三方依赖。

核心能力与快速开始

★ 6 · TypeScript

能做什么
读取 Claude Code 自身的会话注册表,将本机所有会话(含在 VS Code 或终端中启动的)汇总到一个页面并按仓库分组,通过进程存活状态判断 live/idle,标记等待回答的会话。会话行带有 WORK、WAIT、LIVE、IDLE、DONE 状态;支持检查点列出每次提示与提问并可跳转;从会话分支到独立 worktree;提供 diff、编辑器(CodeMirror 6)、终端(xterm.js + 真实 PTY)、git、worktrees、issues(基于 gh CLI)、skills 和仓库结构 MAP(基于 tree-sitter AST 的 graphify)。当遇到 5 小时或每周用量上限时,会暂存会话并按阶梯尝试其它 Claude 账户、不同供应商的免费 agent(opencode)或读取真实重置时间后接续,且可跨重启恢复。支持桌面仪表盘(127.0.0.1:8790)、Telegram Mini App、Telegram bot 以及原生 Claude Code 四种界面共享同一会话存储。提供命令队列(排序、暂停、重试)、上下文用量计量、多账户叠加登录(各自 CLAUDE_CONFIG_DIR 并符号链接回 ~/.claude)、十条显示主题、以及 mystical export/import 的整机迁移命令。
适用场景
用于同时运行多个 Claude Code 会话的开发者集中查看与管理本机会话;在 VS Code 或终端之外发起的会话被遗漏时统一接管;当用量上限触发时自动切换账户或降级到免费供应商继续未完成的工作;离开工位时通过 Telegram bot 或 Mini App 从手机应答会话;按仓库查看会话历史、turn 数、成本与所用模型;在与会话相同的 worktree 上做分支、diff、提交、推送和终端操作;把 GitHub issues 通过 gh CLI 转为提示;通过 mystical export/import 把本机 Claude 配置、仓库状态和历史迁移到新机器。
项目形态
可直接使用的工具
部署方式
在本地机器运行,提供 setup.sh 安装与神秘的 CLI 命令(start/stop/restart/status/doctor/logs/run/export/import)。仪表盘默认监听 127.0.0.1:8790,仅本地不对外发布;手机端 Telegram Mini App 需要可选的小型 tunnel 客户端。未说明更具体的生产部署条件。
主要依赖
需要已安装并登录的 claude CLI(复用现有登录,无需 API 密钥)、Python 3.10+、npm(仅首次构建仪表盘 UI 时使用,运行时不跑 Node)。可选:Telegram 账号(用于 bot 与手机 Mini App)、小型 tunnel 客户端(手机 Mini App)、opencode(约 60MB,用于免费供应商 fallback)。支持 macOS、Linux、WSL。未说明具体硬件要求。
使用限制
仅面向 Claude Code 会话体系,依赖 claude CLI 与其会话注册表。服务端虽为 Python 标准库,但首次构建 UI 需要 npm 与网络。额外 Claude 账户、免费供应商 fallback 与用量限制相关的可用性取决于相应账户与平台的配额策略,具体成本与限制未说明。Telegram bot 与 Mini App 为可选组件。材料未说明并发规模上限、多用户共享或安全审计结论。
许可证
MIT
最近推送
2026-10-08 22:27

资料检查:2026-10-09 07:00 · 卡片整理:2026-10-09 07:00
卡片由 AI 根据仓库资料整理,未进行安装或运行验证 · 本次更新未完成,保留上次成功内容

这是基于来源内容整理的摘要。原文链接失效后,本页摘要和讨论仍会保留。

讨论 0

登录后参与讨论,阅读资讯无需注册。

还没有评论,来分享第一个看法。