wande CLI

Command-line interface for automating your Wande Task Manager workspace through bot tokens.

Requirements

• Node.js 18+
• A valid bot token generated in Settings -> Bot API
• Your Convex HTTP URL (for example: https://<deployment>.convex.site)

Install

npm i -g @krl-grn/wande

Quick start

wande login <BOT_TOKEN>
wande whoami --json

Core commands

Tasks

wande tasks:list --limit 20 --json
wande tasks:list --project-id <PROJECT_ID> --json
wande tasks:list --project "Project Name" --json
wande tasks:create --title "Task from CLI" --status new --json
wande tasks:status --id <TASK_ID> --status done --json

Routines

wande routines:list --limit 20 --json
wande routines:create --title "Routine from CLI" --status new --json
wande routines:status --id <ROUTINE_ID> --status done --json

Projects

wande projects:list --json
wande projects:create --title "CLI Project" --json

Queue instances

wande queue:list --date 2026-02-23 --json
wande queue:create --date 2026-02-23 --entity-id e1 --entity-type task --title "Queue item" --status new --json
wande queue:status --instance-id <INSTANCE_ID> --status done --json

Security notes

• Bot tokens are shown only once when created. Save them securely.
• If a token is exposed, revoke it immediately in Settings -> Bot API and create a new one.
• The CLI stores token config locally for your user profile.

API behavior and limits

• Supported entities: tasks, routines, projects, queueInstances
• Bot is allowed to:
  • read tasks/routines/projects/queueInstances
  • create tasks/routines/projects/queueInstances
  • update status for tasks/routines/queueInstances
• Bot is not allowed to:
  • delete entities
  • reorder entities
  • change date/time/order for existing queue instances
• Rate limits (server-side):
  • 60 req/min per token
  • 20 create/min per token
  • 200 create/day per token

Troubleshooting

• 401 UNAUTHORIZED: token is invalid, expired, or revoked.
• 403 FORBIDDEN: token is missing required scopes.
• 429 RATE_LIMITED: you exceeded rate limits; retry later.
• Could not find public function ...: run Convex dev/deploy so bot functions are available.
• login resolves URL automatically from https://wande.app/api/cli/config. If needed, override with --url.

Development

From repository root:

npm run cli:install
npm run cli:build
node packages/cli/dist/index.js --help