@msgmesh/cli

@msgmesh/cli

MsgMesh 的終端工具:一支 msgmesh 指令,收發事件、即時 tail、查用量。

MsgMesh 是架在 Kafka 之上的多租戶事件總線。這個 CLI 是 @msgmesh/sdk 的薄封裝——所有動作都走 SDK， 和面板 / MCP server 共用同一套 HTTP 契約。

安裝

npm i -g @msgmesh/cli

或免安裝直接跑:

npx -y @msgmesh/cli topics

設定

用環境變數驅動。API Key 請先到面板註冊帳號、於 Keys 頁簽發:

變數	說明	預設
MQ_API_KEY	API Key(必要)。	—
MQ_CONTROL_PLANE_URL	管理 API(建 topic / 查用量)。	http://localhost:8080
MQ_GATEWAY_URL	收發 API(publish / consume）。	http://localhost:8081

線上環境兩個 URL 都指向 https://msgmesh-api.alderflux.com。

指令

msgmesh topics                   列出 topics
msgmesh create-topic <name>      建立 topic
msgmesh publish <topic> <json>   發送訊息
msgmesh tail <topic> [group]     即時輪詢接收(Ctrl-C 結束)
msgmesh usage                    本期用量

範例:

export MQ_API_KEY=sk_...
export MQ_CONTROL_PLANE_URL=https://msgmesh-api.alderflux.com
export MQ_GATEWAY_URL=https://msgmesh-api.alderflux.com

msgmesh create-topic orders
msgmesh publish orders '{"id":1,"status":"paid"}'
msgmesh tail orders

不帶指令(或 msgmesh help)會印出用法。

相關

• 文件 / API 參考:https://msgmesh.alderflux.com/docs
• TypeScript SDK:@msgmesh/sdk
• MCP server:@msgmesh/mcp-server

授權

MIT