turso-provider

Manage Waggle tasks via Turso HTTP API with shell scripts.

3|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/kazukinagata/waggle --skill turso-provider
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: turso-provider
Source: https://github.com/kazukinagata/waggle/tree/main/providers/turso/skills/turso-provider
Command: npx skills add https://github.com/kazukinagata/waggle --skill turso-provider

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, curl, and includes scripts (resource) components.

What problem does it solve?

Turso-provider enables Waggle to run its task board on a Turso database, giving teams a scalable, serverless backend for multi-agent coordination without managing a local database.

Core Features & Use Cases

  • Config retrieval and environment setup from ~/.waggle/config.json, loading tursoUrl and tursoAuthToken into session variables for scripts.
  • Schema initialization, CRUD operations, and task queries via the provided scripts (turso-exec.sh, init-db.sh, query-tasks.sh) to manage tasks, dependencies, and teams.
  • Use Case: Deploy Waggle with Turso to coordinate distributed agents across multiple machines with centralized task storage and real-time views.

Quick Start

Configure your Waggle setup to use Turso by filling ~/.waggle/config.json with tursoUrl and tursoAuthToken, then run the init and task scripts to manage tasks.

Frequently Asked Questions about turso-provider

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use Turso as a backend for Waggle task management?

You can use Turso as a backend for Waggle by loading your tursoUrl and tursoAuthToken from ~/.waggle/config.json, then running the provided shell scripts to initialize the schema and execute CRUD operations via Turso's HTTP API.

Can I coordinate distributed Waggle agents across multiple machines with Turso?

Yes, coordinating distributed Waggle agents across multiple machines with Turso is supported, providing centralized task storage and real-time views for multi-agent coordination without local database management.

Do I need jq and curl to run Turso database operations in Waggle?

Yes, jq and curl are required dependencies because the Skill executes SQL and manages tasks through shell scripts that use curl for Turso HTTP API requests and jq for parsing structured output.

What is the best way to initialize a database schema for Waggle tasks on Turso?

The best way to initialize a database schema for Waggle tasks on Turso is running the init-db.sh script after configuring ~/.waggle/config.json, which creates tables and enforces basic schema validation for tasks, dependencies, and teams.

Does Waggle support safe SQL execution when querying tasks on Turso?

Yes, Waggle supports safe SQL execution when querying tasks on Turso by using the turso-exec.sh and query-tasks.sh scripts, which enforce basic schema validation and return structured output compatible with the view server.

Why configure ~/.waggle/config.json before running Turso task scripts?

Configuring ~/.waggle/config.json is necessary because it loads tursoUrl and tursoAuthToken into session variables, providing the required endpoint and authentication credentials for subsequent shell scripts to execute safe SQL operations.