Skip to main content

An AI-powered CLI tool for automating non-programming daily tasks

Project description

Shen

PyPI version Python Version License: MIT

这个项目会是一个AI命令行工具,专注于处理编程以外的事情

因为我看到了Claude Code神一样的编程能力,他的交互和效果令我惊讶。

因此我在寻找一个类似的命令行工具,这个命令行工具不是专注于编程的,而是专注于处理其他工作。 让使用者能得到更大的效率提升。

这是一个探索性的项目,主要是为了探索CLI+MCP结合帮助使用者完成工作的常规任务。

选择使用python实现

FAQ

为什么是做命令行工具?

  1. 目前已经很多通用GUI的AI软件、AI IDE、AI plugin了,所以再做一个轮子的意义感觉不大
  2. 如果你使用AI的强度比较高,你一定感受到了,无论是cursor还是augment之类的AI IDE或者是vscode插件,都受到其本身的制约,无法发挥出最强能力,这种情况无法避免,而Claude Code是CLI,因此他避开了这个问题。
  3. 不一定所有的工作都在前台完成,也不一定所有的工作都在个人计算机完成。CLI会带来更多玩法和可能性,也许能派遣他到服务器上去(得足够安全),或者在后台运行,自动化通过TODOs读取任务并解决

CLI的优势是什么?

  1. CLI有更强的跨平台性(虽然普通用户可能会无法使用)
  2. CLI受到的限制更少,能拥有的操作权限更大
  3. 更多任务的并行可能
  4. 更强的集成能力,他应该能被其他软件集成,就像ffmpeg那样

可能的工作?

他可能会聚合很多MCP服务,理解整个计算机中有哪些文档和软件,帮助用户完成文档整理、垃圾清理、提供必要信息、制作excel、world、安全检查、软件安装(软件安装我觉得对我一直很头疼,总是报错很烦)等一些常规工作


不过目前的确没有想好他和Claude Code的真正差异是什么,感觉Claude Code除了写代码,其他事情也干的不错。 我还得仔细思考一下。

安装

从 PyPI 安装(推荐)

pip install shen-cli

从源码安装

git clone https://github.com/shenjingnan/shen.git
cd shen
pip install -e .

使用方法

基本命令

# 查看版本
shen --version

# 查看帮助
shen --help

# 获取 Shen 信息
shen info

# 列出可用插件
shen plugins

# 运行任务
shen run "帮我整理下载文件夹"

# 交互模式运行任务
shen run "检查系统安全" --interactive

调试模式

# 启用调试模式
shen --debug info

开发

环境设置

# 安装 Poetry
pip install poetry

# 安装依赖
poetry install

# 激活虚拟环境
poetry shell

运行测试

# 运行所有测试
poetry run pytest

# 运行测试并查看覆盖率
poetry run pytest --cov

# 运行特定测试
poetry run pytest tests/test_cli.py

代码质量

# 格式化代码
poetry run black src tests

# 代码检查
poetry run ruff check src tests

# 类型检查
poetry run mypy src

# 运行所有检查
poetry run black src tests && poetry run ruff check src tests && poetry run mypy src

贡献指南

  1. Fork 项目
  2. 创建功能分支 (git checkout -b feature/amazing-feature)
  3. 提交更改 (git commit -m 'Add some amazing feature')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 开启 Pull Request

许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

shen_cli-0.0.0b0.tar.gz (8.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

shen_cli-0.0.0b0-py3-none-any.whl (10.6 kB view details)

Uploaded Python 3

File details

Details for the file shen_cli-0.0.0b0.tar.gz.

File metadata

  • Download URL: shen_cli-0.0.0b0.tar.gz
  • Upload date:
  • Size: 8.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.12.9 Darwin/22.1.0

File hashes

Hashes for shen_cli-0.0.0b0.tar.gz
Algorithm Hash digest
SHA256 654251818253f4339f3530053b621bb4001d105f70efb718bd640163bf86f11b
MD5 37b0f3d9bcd4c0a6222f864d94096c4c
BLAKE2b-256 46c7e0c8780d8ea960fe4044b765f126228d3d61c10902504d962cd31130f45a

See more details on using hashes here.

File details

Details for the file shen_cli-0.0.0b0-py3-none-any.whl.

File metadata

  • Download URL: shen_cli-0.0.0b0-py3-none-any.whl
  • Upload date:
  • Size: 10.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.12.9 Darwin/22.1.0

File hashes

Hashes for shen_cli-0.0.0b0-py3-none-any.whl
Algorithm Hash digest
SHA256 8d74df629de165403d6d93c8838f9599c73c2df32c4098849592b6145e20dd4e
MD5 2f3ff1d093603fcb10d4c550cf7e3c8d
BLAKE2b-256 4f69e3010466497987d7e2ba1c9740770cf84623ca0702ddc71632a02b61efe6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page