Author SHA1 Message Date
discountry 74d0a0a98b Update package.json and README files to include repository information and enhance CLI command mode documentation
- Added repository details to package.json for better project visibility.
- Revised README files in both English and Chinese to improve the clarity and accessibility of the `ritmex-bot` CLI command mode instructions.
- Included installation instructions for adding the project as a skill, enhancing user onboarding experience.
2026-02-27 12:55:28 +08:00
discountry 674a6fe0da Add CLI user guides and .npmignore file
- Introduced English and Chinese user guides for the `ritmex-bot` CLI, detailing command usage and options.
- Created a new `.npmignore` file to exclude documentation directories from npm package distribution.
- Updated README files to link to the new user guides directly, ensuring easy access for users.
2026-02-27 12:47:32 +08:00
DisneyandGitHub 4014a86223 Enhance CLI command mode for ritmex-bot (#23)
- Introduced a new command mode for `ritmex-bot`, allowing agent-friendly structured trading operations without entering the Ink interactive menu.
- Updated `package.json` to include versioning and set the project as public with a new CLI entry point.
- Enhanced documentation in both English and Chinese to provide comprehensive usage instructions for the new command mode.
- Added a new executable script for `ritmex-bot` to facilitate command execution.
- Improved error handling and command parsing for better user experience and clarity in command execution.
2026-02-27 12:42:20 +08:00
6 changed files with 41 additions and 22 deletions
+3
View File
@@ -0,0 +1,3 @@
docs/
.claude/
.cursor/
+17 -11
View File
@@ -8,15 +8,6 @@ A Bun-powered multi-exchange perpetuals workstation that ships an SMA30 trend en
基于 Bun 的多交易所永续合约量化终端,内置趋势跟随(SMA30)、Guardian 防守与做市策略,支持快速恢复、实时行情订阅、日志追踪与 CLI 仪表盘。 基于 Bun 的多交易所永续合约量化终端,内置趋势跟随(SMA30)、Guardian 防守与做市策略,支持快速恢复、实时行情订阅、日志追踪与 CLI 仪表盘。
## CLI 命令模式(ritmex-bot
`ritmex-bot` 支持 Agent 友好的结构化命令调用,覆盖交易所能力查询、行情、账户、仓位、下单、撤单与策略启动。
- 保持现有环境变量体系,不新增也不改名,只读取当前执行环境中的变量。
- `--symbol` 原样透传,不对交易对做统一改写。
- 支持 `--dry-run` 模拟执行与 `--json` 结构化输出,便于自动化系统集成。
完整文档请见:[ritmex-bot CLI 使用手册(中文)](docs/cli-guide.md)
如果您希望获取优惠并支持本项目,请考虑使用以下注册链接: 如果您希望获取优惠并支持本项目,请考虑使用以下注册链接:
* [Lighter 手续费优惠注册链接](https://app.lighter.xyz/?referral=111909FA) * [Lighter 手续费优惠注册链接](https://app.lighter.xyz/?referral=111909FA)
@@ -30,9 +21,24 @@ A Bun-powered multi-exchange perpetuals workstation that ships an SMA30 trend en
* [Paradex 手续费优惠注册链接](https://paradex.io/ref/xingxingjun) * [Paradex 手续费优惠注册链接](https://paradex.io/ref/xingxingjun)
* [Apex 手续费优惠注册链接](https://join.omni.apex.exchange/SEA) * [Apex 手续费优惠注册链接](https://join.omni.apex.exchange/SEA)
## CLI 命令模式(ritmex-bot
`ritmex-bot` 支持 Agent 友好的结构化命令调用,覆盖交易所能力查询、行情、账户、仓位、下单、撤单与策略启动。
- 保持现有环境变量体系,不新增也不改名,只读取当前执行环境中的变量。
- `--symbol` 原样透传,不对交易对做统一改写。
- 支持 `--dry-run` 模拟执行与 `--json` 结构化输出,便于自动化系统集成。
### 安装当前项目 Skillskills add
```bash
npx skills add https://github.com/discountry/ritmex-bot --skill use-ritmex-bot
```
如需指定分支,可追加 `--ref <branch-or-tag>`
完整文档请见:[ritmex-bot CLI 使用手册(中文)](cli-guide.md)
## 文档索引 ## 文档索引
- [ritmex-bot CLI 使用手册(中文)](docs/cli-guide.md) - [ritmex-bot CLI 使用手册(中文)](cli-guide.md)
- [ritmex-bot CLI User Guide (English)](docs/cli-guide.en.md) - [ritmex-bot CLI User Guide (English)](cli-guide.en.md)
- [简明上手指南(零基础)](simple-readme.md) - [简明上手指南(零基础)](simple-readme.md)
- [基础网格策略使用教程](grid-trading.md) - [基础网格策略使用教程](grid-trading.md)
+17 -11
View File
@@ -4,15 +4,6 @@
A Bun-powered multi-exchange perpetuals workstation that ships an SMA30 trend engine, a Guardian stop sentinel, and two market-making modes. It offers instant restarts, realtime market data, structured logging, and an Ink-based CLI dashboard. A Bun-powered multi-exchange perpetuals workstation that ships an SMA30 trend engine, a Guardian stop sentinel, and two market-making modes. It offers instant restarts, realtime market data, structured logging, and an Ink-based CLI dashboard.
## CLI Command Mode (`ritmex-bot`)
`ritmex-bot` provides an agent-friendly command interface for exchange capability checks, market data, account/position queries, order operations, and strategy execution.
- It keeps the current environment-variable system intact: no renaming and no new required keys.
- `--symbol` is passed through exactly as provided (no symbol normalization).
- It supports `--dry-run` simulation and `--json` structured output for automation.
Full guide: [ritmex-bot CLI User Guide (English)](docs/cli-guide.en.md)
If you'd like to support this project and get fee discounts, please consider using these referral links: If you'd like to support this project and get fee discounts, please consider using these referral links:
* [Lighter referral link](https://app.lighter.xyz/?referral=111909FA) * [Lighter referral link](https://app.lighter.xyz/?referral=111909FA)
@@ -26,9 +17,24 @@ If you'd like to support this project and get fee discounts, please consider usi
* [Paradex referral link](https://paradex.io/ref/xingxingjun) * [Paradex referral link](https://paradex.io/ref/xingxingjun)
* [Apex referral link](https://join.omni.apex.exchange/SEA) * [Apex referral link](https://join.omni.apex.exchange/SEA)
## CLI Command Mode (`ritmex-bot`)
`ritmex-bot` provides an agent-friendly command interface for exchange capability checks, market data, account/position queries, order operations, and strategy execution.
- It keeps the current environment-variable system intact: no renaming and no new required keys.
- `--symbol` is passed through exactly as provided (no symbol normalization).
- It supports `--dry-run` simulation and `--json` structured output for automation.
### Install This Project Skill (`skills add`)
```bash
npx skills add https://github.com/discountry/ritmex-bot --skill use-ritmex-bot
```
If you need a specific branch/tag, append `--ref <branch-or-tag>`.
Full guide: [ritmex-bot CLI User Guide (English)](cli-guide.en.md)
## Documentation Map ## Documentation Map
- [ritmex-bot CLI User Guide (English)](docs/cli-guide.en.md) - [ritmex-bot CLI User Guide (English)](cli-guide.en.md)
- [ritmex-bot CLI 使用手册(中文)](docs/cli-guide.md) - [ritmex-bot CLI 使用手册(中文)](cli-guide.md)
- [Beginner-friendly Quick Start](simple-readme.md) - [Beginner-friendly Quick Start](simple-readme.md)
- [Grid Trading Strategy Guide](grid-trading.md) - [Grid Trading Strategy Guide](grid-trading.md)
View File
+4
View File
@@ -4,6 +4,10 @@
"module": "index.ts", "module": "index.ts",
"type": "module", "type": "module",
"private": false, "private": false,
"repository": {
"type": "git",
"url": "https://github.com/discountry/ritmex-bot.git"
},
"bin": { "bin": {
"ritmex-bot": "./bin/ritmex-bot" "ritmex-bot": "./bin/ritmex-bot"
}, },