clu
# clu
SSH 会话保持与管理 + Slurm 集群 / 普通服务器的 AI agent 能力层。
一个常驻 daemon 持有 SSH 连接池、tmux 托管会话与执行留痕；Claude Code（MCP）
与人类（`clu` CLI）作为两个薄客户端共享同一套能力。
> 状态：M0 骨架阶段，尚未发布。设计共识与里程碑见 [DESIGN.md](DESIGN.md)。
总体架构图（交互式，明暗主题）：[docs/architecture.html](docs/architecture.html)
使用说明：[docs/usage.md](docs/usage.md)
## 安装（计划）
```bash
uv tool install clu-ssh
```
## 接入 Claude Code（MCP）
```bash
# 项目级（推荐，随仓库共享）
claude mcp add clu -- clu-mcp
# 或用户级
claude mcp add --scope user clu -- clu-mcp
```
工具面（只读工具带 read-only hint，可配置免确认）：
| 工具 | 说明 |
|---|---|
| `exec` | 远程执行单条命令（受安全门约束） |
| `jobs` / `status` / `log` | 作业列表 / 集群概览 / 作业日志（只读） |
| `submit` / `cancel` | 提交 / 取消作业 |
| `ledger_query` | 检索执行留痕（跨会话记忆，只读） |
| `connection_list` | 连接与连接池状态（只读） |
## 开发
```bash
uv sync # 安装依赖（含 dev 组）
uv run clu --help # CLI
uv run pytest # 单元测试
uv run ruff format . # 格式化
uv run ruff check . # 静态检查
uv run mypy # 类型检查（strict）
```
CI（GitHub Actions）在 macOS 与 Linux 矩阵上运行同一套检查。
## License
MIT
TDQS
Scored across 15 tools
Most tools have clearly distinct purposes (exec vs submit vs alloc, session_* vs jobs, upload vs download). Minor overlap exists between status and resources for cluster overview, and between log and session_info for log tail, but descriptions help differentiate.
Naming mixes short imperative verbs (exec, submit, alloc, cancel, log) with prefixed noun patterns (ledger_query, session_list, connection_list). The set is readable but not a single consistent verb_noun convention.
15 tools is well within the typical 3–15 range and each tool maps to a distinct capability (remote exec, job lifecycle, resource query, session management, file transfer, connection listing). No obvious redundant tools.
Core workflows are covered: command execution, job submission/monitoring/cancel, resource allocation, session management, and file transfer. Minor gaps include no dedicated job detail/history tool (e.g., sacct) and no connection create/delete management, though workarounds via exec exist.