clu
SSH 会话保持与管理 + Slurm 集群 / 普通服务器的 AI agent 能力层。
一个常驻 daemon 持有 SSH 连接池、tmux 托管会话与执行留痕；Claude Code（MCP）
与人类（clu CLI）作为两个薄客户端共享同一套能力。
状态：M0 骨架阶段，尚未发布。设计共识与里程碑见 DESIGN.md。
总体架构图（交互式，明暗主题）：docs/architecture.html 使用说明：docs/usage.md
安装（计划）
uv tool install clu-ssh
接入 Claude Code（MCP）
# 项目级（推荐，随仓库共享）
claude mcp add clu -- clu-mcp
# 或用户级
claude mcp add --scope user clu -- clu-mcp
工具面（只读工具带 read-only hint，可配置免确认）：
| 工具 | 说明 |
|---|---|
exec |
远程执行单条命令（受安全门约束） |
jobs / status / log |
作业列表 / 集群概览 / 作业日志（只读） |
submit / cancel |
提交作业（脚本/日志入 ~/.clu/jobs/，台账可查）/ 取消作业 |
job_list |
作业台账（状态定期核对，只读） |
ledger_query |
检索执行留痕（跨会话记忆，只读） |
connection_list |
连接与连接池状态（只读） |
开发
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
1 maintainer
Metadata
1 maintainer
Release files for clu-ssh 0.1.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| clu_ssh-0.1.3.tar.gz | 364.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| clu_ssh-0.1.3-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 429.1 kB
Release files / clu_ssh-0.1.3.tar.gz
| Download URL | clu_ssh-0.1.3.tar.gz |
|---|---|
| Size | 364.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
83dd193d9c151394a3797e4a50e17da8edce668bbdb15856607106788030eea0
|
|
BLAKE2b-256 checksum How to use checksums |
6a78cc79491a9a6e59c0b3f5f6054431738fb21320d3c3edf8cde1240be5c6c3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / clu_ssh-0.1.3-py3-none-any.whl
| Download URL | clu_ssh-0.1.3-py3-none-any.whl |
|---|---|
| Size | 64.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9c4c346d4218c6345dfc42b005c6d375622e7b032120d7f3b7b365c4d7aa41c3
|
|
BLAKE2b-256 checksum How to use checksums |
22595056a02a01ca7397ffccfb36eb6e2737667bfea4faba3dae87a4944de7d7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.13.4 {"installer":{"name":"uv","version":"0.13.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for clu-ssh 0.1.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
