Skip to main content
skill CX Codex

turso-cloud — Claude Code skill: what it does, how to install

Supplies agent instructions for Turso Cloud, the managed SQLite platform. Useful when configuring client SDKs, restricting auth tokens, and provisioning databases.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add tursodatabase/agent-skills --skill turso-cloud -a claude-code
Open on GitHub

What turso-cloud does

This skill equips agents with reference material for Turso Cloud. It covers client libraries for JavaScript and TypeScript (@tursodatabase/serverless), Python (pyturso, libsql), Go (tursogo, libsql-client-go), and Rust (turso, libsql). It details queries, batches, and interactive transactions.

It covers local-first replication alongside Turso Cloud built-in capabilities: vector search with DiskANN indexing, BM25 full-text search, copy-on-write branching, and point-in-time recovery. The documentation also details credential management, including scoping tokens by database or table and connecting JWKS providers like Clerk or Auth0.

Deploying changes and managing resources requires the Turso CLI or Vercel CLI, because the skill only provides documentation and commands for those tools.

What it helps with

  • connect Node.js, Python, Go, or Rust applications to Turso Cloud
  • configure local-first replication with @tursodatabase/sync or pyturso
  • restrict database tokens or integrate external auth via Clerk and Auth0
  • provision Turso databases through the Vercel Marketplace integration

Example prompts for the agent

  • Connect this Python service to Turso Cloud using pyturso with local sync
  • Create a scoped read-only auth token for our database using the Turso CLI
  • Set up vector search using DiskANN indexing and cosine distance in Turso

How to install turso-cloud

1Skills CLI (Vercel)

npx skills add tursodatabase/agent-skills --skill turso-cloud -a claude-code

2Manually: put the files in place

~/.claude/skills/turso-cloud/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/turso-cloud/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about turso-cloud

How do I install turso-cloud in Claude Code?

Run npx skills add tursodatabase/agent-skills --skill turso-cloud -a claude-code in your terminal.

What does the turso-cloud skill do?

It provides reference guides for connecting applications to Turso Cloud, managing scoped JWT credentials, using embedded replicas, and provisioning through Vercel.

Which languages and SDKs are covered in turso-cloud?

The skill covers TypeScript and JavaScript (@tursodatabase/serverless), Python (pyturso, libsql), Go (tursogo, libsql-client-go), and Rust (turso, libsql).

Source text

SKILL.md · MIT
---
name: turso-cloud
description: >
  Turso Cloud — fully managed SQLite-compatible database platform, accessed over the network.
  Use when connecting an application to a Turso Cloud database, creating or scoping auth tokens
  (JWT, fine-grained permissions, JWKS/external auth providers), or provisioning and managing
  cloud databases. Covers per-language SDKs (JavaScript/TypeScript, Python, Go, Rust),
  authentication & authorization, and marketplace integrations (Vercel).
---

# Turso Cloud Skills

This skill combines documentation for working with Turso Cloud, the fully managed SQLite-compatible database platform. Pick the relevant sub-skill below.

## [turso-cloud-js](turso-cloud-js/overview.md)

Work with the `@tursodatabase/serverless` TypeScript/JavaScript SDK for remote Turso Cloud databases — queries, positional/named parameters, batches, and interactive transactions — plus the local-first sync family (`@tursodatabase/sync`, `-wasm`, `-react-native`). Use when connecting to Turso Cloud from Node.js, serverless/edge functions, browsers, or React Native.

## [turso-cloud-py](turso-cloud-py/overview.md)

Work with Turso Cloud from Python: `pyturso` for local-first databases that sync with the cloud, and `libsql` for remote-only access over the libsql protocol. Use when connecting Python applications to Turso Cloud.

## [turso-cloud-go](turso-cloud-go/overview.md)

Work with Turso Cloud from Go: `tursogo` for local-first databases that sync with the cloud, and `libsql-client-go` for remote-only access over the libsql protocol. Use when connecting Go applications to Turso Cloud.

## [turso-cloud-rust](turso-cloud-rust/overview.md)

Work with Turso Cloud from Rust: the `turso` crate (`sync` feature) for local-first databases that sync with the cloud, and the `libsql` crate for remote-only access over the libsql protocol. Use when connecting Rust applications to Turso Cloud.

## [turso-cloud-auth](turso-cloud-auth/overview.md)

Authenticate and authorize access to Turso Cloud databases: database URLs, platform tokens via the Turso CLI, scoping (group/database/read-only/time-limited), fine-grained per-table permissions, external auth providers via JWKS (Clerk, Auth0), and token invalidation. Use when issuing credentials, restricting what a client can do, or wiring an existing auth provider to Turso.

## [turso-cloud-vercel](turso-cloud-vercel/overview.md)

Use and manage Turso Cloud databases provisioned through the Vercel Marketplace (integration slug `tursocloud`): injected environment variables, inspecting and provisioning resources with the Vercel CLI, region selection, and safety rules for credentials and destructive operations. Use when a Vercel project has — or needs — a Turso database.

## Turso Cloud features

Turso Cloud databases support these features out of the box:

- **Vector search** — native similarity search for AI/RAG workflows, no extensions needed. Supports cosine, L2, and L1 distance functions with DiskANN indexing.
- **Full-text search** — keyword search with BM25 ranking via built-in FTS support.
- **AI & embeddings** — native vector types for storing and querying embeddings.
- **Branching** — create isolated copy-on-write database branches for testing/staging.
- **Point-in-time recovery** — restore databases to any previous point in time (retention depends on plan).
- **Embedded replicas** — local replicas that sync with Turso Cloud for fast reads and offline support.
- **SQLite extensions** — JSON, FTS5, R*Tree, SQLean, UUID, regexp.

## Further reading

**Turso online docs** — `https://docs.turso.tech` (Mintlify — append `.md` to any URL path for raw markdown, e.g. `https://docs.turso.tech/sdk/ts/quickstart.md`). Each sub-skill carries its own docs links; general references:

| Topic | URL |
|-------|-----|
| AI & embeddings | `https://docs.turso.tech/features/ai-and-embeddings.md` |
| Embedded replicas | `https://docs.turso.tech/features/embedded-replicas/introduction.md` |
| Cloud limitations | `https://docs.turso.tech/cloud/limitations.md` |
| SQLite extensions | `https://docs.turso.tech/features/sqlite-extensions.md` |
| Full docs index (for LLMs) | `https://docs.turso.tech/llms.txt` |

© tursodatabase · MIT · tursodatabase/agent-skills

Similar skills

All skills for Data and databases →

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor