Metadata-Version: 2.4
Name: coral-cli
Version: 0.1.2
Summary: 珊瑚平台 Python CLI 示例
Author-email: "vic.lv" <17625642535@163.com>
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0.0
Requires-Dist: platformdirs>=4.2.0
Requires-Dist: requests>=2.31.0

# coral-cli

这是一个面向珊瑚平台的 Python CLI。当前已经支持通过账号密码登录，并把 `access_token` 持久化到本地，后续命令可以复用登录态。

## 安装

```bash
pip install -e .
```

## 命令

```bash
coral-cli login -uid your-account -password your-password
coral-cli whoami
coral-cli project
coral-cli logout
```

`coral-cli login` 现在要求显式传入账号和密码参数：

```bash
coral-cli login -uid vic.lv -password 'your-password'
```

登录成功后，会把认证信息保存到用户配置目录下的 `coral-cli/auth.json`。后续命令可以直接读取该文件中的 `access_token`，从而保持登录态。

## Agent 使用建议

像 openclaw 这样的 Agent 在调用前，应先询问用户账号和密码，然后执行登录命令，再继续其他功能命令：

```bash
coral-cli login -uid <uid> -password <password>
coral-cli project
```

如果要避免重复登录，可以先执行 `coral-cli whoami` 检查当前是否已有有效登录态。
