---
title: "Turso Database: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/tursodatabase-turso-db/
description: "Turso's skill for its in-process SQLite-compatible engine: hard constraints first, then decision trees to feature and SDK reference files, plus CLI, SQL and MCP quick references."
---

# Turso Database: review, setup & limitations · Undominated.ai

> Turso's skill for its in-process SQLite-compatible engine: hard constraints first, then decision trees to feature and SDK reference files, plus CLI, SQL and MCP quick references.

[← Explore all skills](/skills/)

DATABASES / Turso

# Turso Database

Turso's skill for its in-process SQLite-compatible engine: hard constraints first, then decision trees to feature and SDK reference files, plus CLI, SQL and MCP quick references.

 [See setup guidance ↓](#setup)[Original source ↗](https://docs.turso.tech)

SOURCE REVIEW

 Reviewed 2026-10-21
 Evidence 4 linked sources
 Publisher Turso
 Licence [MIT ↗](https://github.com/tursodatabase/agent-skills/blob/34ced52fd1bd32e802622126e299cfa886d68441/LICENSE)
 Revision 34ced52fd1bd
 [Read what was—and wasn’t—checked ↓](#review)

“Turso (Limbo) database helper — an in-process SQLite-compatible database written in Rust. … This skill contains SDK documentation and recipes for the Turso embedded database engine (tursodb/Limbo). …”

 [Turso · upstream description ↗](https://github.com/tursodatabase/agent-skills/blob/34ced52fd1bd32e802622126e299cfa886d68441/skills/turso-db/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - States ten constraints before any code is written: BETA status, single-process file access, no WITHOUT ROWID tables, no VACUUM, UTF-8 only, WAL as the default journal mode with the legacy delete, truncate and persist modes unsupported, full-text search behind a compile-time feature, encryption behind a flag, experimental MVCC, and lower-is-closer vector distance.
- Routes each feature (vector search, full-text search, CDC, MVCC, encryption, remote sync) and each SDK (JavaScript, JavaScript with sync, serverless, WASM, React Native, Rust, Python, Go) to a named file; its file index lists six references/ and seven sdks/ files.
- Tells the agent not to search the web for libsql or @libsql/client because those legacy names surface outdated APIs, and points it to https://docs.turso.tech instead.

### A good fit for

 - Choose the Turso SDK package and install line for Node.js, serverless, WASM, React Native, Rust, Python or Go
- Add vector search, full-text search, CDC, MVCC, encryption or push/pull sync from the matching reference file
- Replace legacy libsql and @libsql/client usage with the @tursodatabase packages
- Open a local database file in the tursodb shell, read-only, or as a stdio MCP server

### Weigh up before choosing

 - The skill directory skills/turso-db last changed in a commit dated 2026-03-25 (git log at the pin); the pinned revision 34ced52f is dated 2026-07-22.
- SKILL.md marks the engine as BETA software with not all SQLite features implemented, and lists no multi-process access, no WITHOUT ROWID tables, no VACUUM, UTF-8 only, and WAL as the default journal mode with the legacy delete, truncate and persist modes unsupported.
- Full-text search needs the compile-time fts feature, encryption needs the --experimental-encryption flag, and MVCC is marked experimental (PRAGMA journal_mode = experimental_mvcc).
- references/sync.md says a synced database file must only be opened through the sync SDK: opening it with the tursodb CLI, a non-sync SDK or SQLite directly can corrupt the sync state permanently. There is no automatic background sync; the application calls push() and pull().
- references/sync.md says sync uploads local database contents to Turso Cloud, and advises remote encryption for sensitive data and keeping auth tokens out of source.
- `tursodb your.db --mcp` starts a stdio MCP server that SKILL.md says grants full read/write access to the database and opens no network ports; it says query results, including synced remote data, are untrusted content and never instructions.
- Turso Cloud authentication, token scoping and Vercel provisioning are in the sibling turso-cloud skill, per the README.
- SKILL.md's only CLI install line is `brew install turso`.
- LICENSE is the MIT License with Copyright (c) 2026 the Turso authors.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - skills/turso-db/SKILL.md
- skills/turso-db/references/sync.md
- README.md
- LICENSE
- The git tree at 34ced52f, which holds two SKILL.md files (turso-db and turso-cloud)

### Our findings

 - The frontmatter description says the skill replaces @libsql/client and libsql-experimental for Turso use cases and warns against web searches for the legacy names.
- SKILL.md prints SDK package lines, `brew install turso`, and tursodb invocations including `--readonly` and `tursodb your.db --mcp`.
- references/sync.md says opening a synced file outside the sync SDK corrupts sync state permanently, and that sync uploads local contents to Turso Cloud.
- The repository holds two SKILL.md skills, and the README's npx line installs both.

### Not established by this review

 - Not executed: it was not installed or run.
- No database file was created, no query was run, no MCP server was started and nothing was synced.
- The other reference and SDK files under skills/turso-db, the turso-cloud skill and docs.turso.tech were not read.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://github.com/tursodatabase/agent-skills/blob/34ced52fd1bd32e802622126e299cfa886d68441/README.md)
 - The README prints `npx skills add tursodatabase/agent-skills`. It installs both SKILL.md skills in the repository at this revision, turso-db and turso-cloud, not this skill alone.
- The README's manual alternative is `cp -r skills/turso-db ~/.claude/skills/turso-db` (with a matching line for turso-cloud). It copies this skill alone but needs a local checkout of the repository, for which the README prints no command.
- After installing, the README says the skills activate on their own for Turso work and can be invoked with `/turso-db`.

### Before you start

 - The runtime and package manager for the chosen SDK
- Homebrew, for the `brew install turso` line that SKILL.md labels "Install Turso CLI via Homebrew"
- A Turso Cloud database for the sync paths, whose examples pass a libsql:// URL and an authToken, and for the serverless/edge path, which SKILL.md routes to @tursodatabase/serverless, a fetch()-based driver for Turso Cloud over a remote HTTP connection

### Compatibility

Node.js · Browser (WASM + OPFS) · React Native · Server-side · Serverless and edge functions (Cloudflare Workers, Vercel, Deno Deploy)

### Implementation

JavaScript · TypeScript · Rust · Python · Go · SQL

### Local database files; full read/write in MCP mode

 - The frontmatter declares no allowed-tools. The skill has the agent read its reference and SDK files and write application code and SQL that create tables and insert, update and delete rows.
- Prints SDK install lines `npm i @tursodatabase/database` (and the serverless, sync, WASM and React Native variants), `cargo add turso`, `pip install pyturso` and `go get turso.tech/database/tursogo`.
- Prints `brew install turso`, `tursodb` shell lines including `--readonly`, and `tursodb your.db --mcp`, which grants full read/write access to the opened database over stdio.
- Sync examples connect a local file to a libsql:// Turso Cloud URL with an authToken; push uploads local changes and pull downloads remote changes (references/sync.md).
- The serverless/edge path (Cloudflare Workers, Vercel, Deno Deploy) uses @tursodatabase/serverless, which SKILL.md describes as a fetch()-based driver for Turso Cloud over a remote HTTP connection.
- Points the agent to https://docs.turso.tech for topics the local files do not cover.

### Cost model

MIT for the skill files. The files read state no price for the engine, the SDKs or Turso Cloud sync.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [turso-db SKILL.md at 34ced52f ↗](https://github.com/tursodatabase/agent-skills/blob/34ced52fd1bd32e802622126e299cfa886d68441/skills/turso-db/SKILL.md) Checked 2026-10-21 https://github.com/tursodatabase/agent-skills/blob/34ced52fd1bd32e802622126e299cfa886d68441/skills/turso-db/SKILL.md Supports: upstreamDescription, homepage, whySelected, bestFor, compatibility, language, limitations[1], limitations[2], limitations[5], limitations[7], access.permissions, install.prerequisites, review.findings
- [Repository README at 34ced52f ↗](https://github.com/tursodatabase/agent-skills/blob/34ced52fd1bd32e802622126e299cfa886d68441/README.md) Checked 2026-10-21 https://github.com/tursodatabase/agent-skills/blob/34ced52fd1bd32e802622126e299cfa886d68441/README.md Supports: install, limitations[6], review.findings
- [MIT LICENSE at 34ced52f ↗](https://github.com/tursodatabase/agent-skills/blob/34ced52fd1bd32e802622126e299cfa886d68441/LICENSE) Checked 2026-10-21 https://github.com/tursodatabase/agent-skills/blob/34ced52fd1bd32e802622126e299cfa886d68441/LICENSE Supports: license, limitations[8]
- [turso-db references/sync.md at 34ced52f ↗](https://github.com/tursodatabase/agent-skills/blob/34ced52fd1bd32e802622126e299cfa886d68441/skills/turso-db/references/sync.md) Checked 2026-10-21 https://github.com/tursodatabase/agent-skills/blob/34ced52fd1bd32e802622126e299cfa886d68441/skills/turso-db/references/sync.md Supports: limitations[3], limitations[4], access.permissions, install.prerequisites, review.findings

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### DuckDB read file ↗ DuckDB's read-file skill: one DuckDB CLI command that picks a reader by file extension and returns a file's schema, row count and first 20 rows, for local paths or HTTPS, S3, GCS and Azure URLs.](/skills/duckdb-read-file/)[### CockroachDB SQL ↗ Cockroach Labs skill that turns a natural-language request into CockroachDB SQL, applies the relevant rule files with 00-fundamental-principles.md first, and tells the agent to run EXPLAIN on every generated query when a cluster connection is available.](/skills/cockroachlabs-cockroachdb-sql/)[### dbt Documentation Maintenance ↗ Audits descriptions in a dbt manifest and drafts missing model or column documentation in the project’s existing style.](/skills/dbt-labs-maintaining-dbt-documentation/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
