@xiashe/cli

xiashe exposes XiaShe core workflows from a local terminal or any shell-capable Agent.

Local development

node packages/xiashe-cli/bin/xiashe.mjs --help
node packages/xiashe-cli/bin/xiashe.mjs config path
node packages/xiashe-cli/bin/xiashe.mjs env use cn
node packages/xiashe-cli/bin/xiashe.mjs login --email [email protected] --password '********' --convex-url https://...

Core workflows

xiashe skills list
xiashe skills install copywriting --connection MaxClaw-1 --watch
xiashe agent issue --name "Local WorkBuddy"
xiashe agent connect --token "<token>" --name "Local WorkBuddy"
xiashe agent run --ack
xiashe chat send --chat "New Chat" --content "帮我处理这个文件" --file ./report.pdf --agent "Local WorkBuddy"

Local state is stored in ~/.xiashe/config.json.

xiashe agent run --ack is the recommended lightweight receiver for shell-capable Agents. It sends cheap heartbeats and only lists/executes work when the backend reports pending tasks or transfers. Default cadence is about 30s while idle, 10s while work is active, and up to 2 minutes after long idle periods.

Production defaults:

• Convex: https://api.xiashe.chat
• Actions: https://actions.xiashe.chat
• Relay: https://relay.xiashe.chat