# Upgrade Duckdb Extension

> Upgrade the duck-read-cache-fs extension to a new DuckDB release. Use when the user asks to upgrade DuckDB, bump the duckdb submodule, sync to a new DuckDB tag (e.g. v1.5.2), or update the duckdb / duckdb-httpfs / extension-ci-tools submodules together. Use when this capability is needed.

- Skill: `tomevault-io/upgrade-duckdb-extension` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/upgrade-duckdb-extension`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/upgrade-duckdb-extension/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/upgrade-duckdb-extension

---


# Upgrade duck-read-cache-fs to a new DuckDB release

Three submodules must move together. Two are pinned to matching release tags, one tracks `main`. Then build, run two test suites, and write a changelog entry.

## Inputs

Before starting, confirm the target DuckDB version (e.g. `v1.5.2`). Everything else is derived from it.

## Workflow

Track these as a checklist; do not skip ahead:

- 1. Pin duckdb submodule to tags/$TARGET
- 2. Pin extension-ci-tools submodule to $TARGET (same tag)
- 3. Pin duckdb-httpfs submodule based on DuckDB repo commit
- 4. Reconcile CMakeLists.txt EXTENSION_SOURCES with duckdb-httpfs/src/*.cpp
- 5. Build: CMAKE_BUILD_PARALLEL_LEVEL=10 make reldebug
- 6. Run test
  + Extension C++ unit test: `./build/reldebug/extension/cache_httpfs/test/unittest/unittest_cache_httpfs`
  + SQL test: `make test_reldebug` (expands to `./build/reldebug/test/unittest "test/*"`)

## Reference: historical upgrade commits

- `97359a4` — `Upgrade duckdb v1.5.2`. Minimal: 3 submodules + 1 CMake source line + CHANGELOG.

---
> Source: [dentiny/duck-read-cache-fs](https://github.com/dentiny/duck-read-cache-fs) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-29 -->