Skip to main content

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 提交 / 取消作业
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

Metadata

Release files for clu-ssh 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for clu-ssh 0.1.1
File Size Uploaded Provenance
clu_ssh-0.1.1.tar.gz 346.7 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for clu-ssh 0.1.1
File Interpreter ABI Platform
clu_ssh-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 402.3 kB

Release files / clu_ssh-0.1.1.tar.gz

Download URL clu_ssh-0.1.1.tar.gz
Size 346.7 kB
Tags Source
SHA-256 checksum
How to use checksums
2a3d296c771b86a97ba00bf231f3739fbd94fc940717f63474b3952eed3c09d0
BLAKE2b-256 checksum
How to use checksums
20d4099802d48dc5d445e5b97e2921eb2989507e91d9ed61124b19f6db2568ca
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.1-py3-none-any.whl

Download URL clu_ssh-0.1.1-py3-none-any.whl
Size 55.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
805fdeedaa33cccc8f357c67b57b0738831e5fa557e466af88748f4d83a6ed44
BLAKE2b-256 checksum
How to use checksums
06877db2d03c55dbff2873ef57153f0fb1e04e9d36e8cde75d860f947b6d85b8
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.1

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page