plutio

# Plutio Skill

Integrate with [Plutio](https://plutio.com/) for project and task management via REST API.

**Platforms**: Works with Linux/macOS (bash) and Windows (PowerShell 7). See [references/powershell-workflows.md](references/powershell-workflows.md) for PowerShell-specific examples.

## Setup

**Complete setup guide**: See [references/setup-guide.md](references/setup-guide.md) for:
- How to get API credentials from Plutio
- Configuring via OpenClaw chat (recommended)
- Command-line setup for Linux, macOS, and Windows
- Secure credential storage (Bitwarden, environment variables)
- Troubleshooting common issues

**Quick summary**:

1. **Get credentials** from Plutio (Settings > API > Create Application)
2. **Ask OpenClaw to configure** (easiest): _"Setup Plutio with Client ID: XXX and Secret: YYY"_
3. **Or set environment variables**:
   - Linux/macOS: `export PLUTIO_APP_KEY="..."`
   - Windows PowerShell: `$env:PLUTIO_APP_KEY = "..."`
4. **Python 3** must be installed

The skill caches access tokens locally (valid for ~1 hour), then automatically refreshes when needed.

## Quick Start

### List all projects
```powershell
python3 $env:USERPROFILE\.openclaw\workspace\skills\plutio\scripts\plutio-cli.py `
  --subdomain grewing `
  --app-key YOUR_APP_KEY `
  --secret YOUR_SECRET `
  list-projects
```

### List tasks in a project
```powershell
python3 $env:USERPROFILE\.openclaw\workspace\skills\plutio\scripts\plutio-cli.py `
  --subdomain grewing `
  --app-key YOUR_APP_KEY `
  --secret YOUR_SECRET `
  list-tasks --project-id PROJECT_ID
```

### Create a task
```powershell
python3 $env:USERPROFILE\.openclaw\workspace\skills\plutio\scripts\plutio-cli.py `
  --subdomain grewing `
  --app-key YOUR_APP_KEY `
  --secret YOUR_SECRET `
  create-task `
    --title "My Task Title" `
    --board-id BOARD_ID `
    --group-id GROUP_ID
```

**Note**: To make tasks appear in the Plutio UI, you **must** provide both `--board-id` (Task List board ID) and `--group-id` (column/grou...