open-index/open-npm huggingface dataset:
npm package: @krl-bg/components
Description: This library was generated with [Nx](https://nx.dev).
Latest version: 0.0.1

# dcr-components

This library was generated with [Nx](https://nx.dev).

## Building

Run `nx build dcr-components` to build the library.

## Running unit tests

Run `nx test dcr-components` to execute the unit tests via [Vitest](https://vitest.dev/).
npm package: @krl-grn/wande
Description: Command-line interface for automating your Wande Task Manager workspace through bot tokens.
Latest version: 0.1.1

# 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

```bash
npm i -g @krl-grn/wande
```

## Quick start

```bash
wande login <BOT_TOKEN>
wande whoami --json
```

## Core commands

### Tasks

```bash
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

```bash
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

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

### Queue instances

```bash
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:

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