tursodatabase/turso

differential-fuzzer

Information about the differential fuzzer tool, how to run it and use it catch bugs in Turso. Always load this skill when running this tool

memory-benchmark

How to benchmark and analyze memory usage in Turso using the memory-benchmark crate and dhat heap profiler. Use this skill whenever the user mentions memory usage, memory profiling, allocation tracking, heap analysis, memory regression, memory benchmarking,…

testing

How to write tests, when to use each type of test, and how to run them. Contains information about conversion of `.test` to `.sqltest`, and how to write `.sqltest` and rust tests

yield-injections

Use when working with Turso yield injection or synthetic failure injection machinery for safe resumable state-machine boundaries, including YieldInjector, FailureInjector, YieldPointMarker, inject_transition_yield!, inject_io_yield!,…

code-quality

General Correctness rules, Rust patterns, comments, avoiding over-engineering. When writing code always take these into account

mvcc

Overview of Experimental MVCC feature - snapshot isolation, versioning, limitations

cdc

Change Data Capture - architecture, entrypoints, bytecode emission, sync engine integration, tests

index-knowledge

Generate hierarchical AGENTS.md knowledge base for a codebase. Creates root + complexity-scored subdirectory documentation.

async-io-model

Explanations of common asynchronous patterns used in tursodb. Involves IOResult, state machines, re-entrancy pitfalls, CompletionGroup. Always use these patterns in `core` when doing anything IO

debugging

How to debug tursodb using Bytecode comparison, logging, ThreadSanitizer, deterministic simulation, and corruption analysis tools

pr-workflow

General guidelines for Commits, formatting, CI, dependencies, security

storage-format

SQLite file format, B-trees, pages, cells, overflow, freelist that is used in tursodb

transaction-correctness

How WAL mechanics, checkpointing, concurrency rules, recovery work in tursodb