v0.3.0 — CLI Polish & Developer Experience

What's New

New Command: tsctl doctor

Check your entire setup in one command — config file, validation, API key, Typesense connection, state collection, and server version.

tsctl doctor

Standard CLI Flags

• -v, --verbose — show detailed output
• -q, --quiet — suppress non-essential output
• --no-color — disable colored output (also respects NO_COLOR env var)
• --debug — show debug information and stack traces

Apply Improvements

• -n, --dry-run — preview what would be applied without making changes
• -t, --target <resources...> — selectively apply specific resources

# Dry run
tsctl apply --dry-run

# Apply only specific resources
tsctl apply --target collection.products alias.products_live

JSON Plan Output

tsctl plan --json

Shell Completions

# Bash
eval "$(tsctl completion bash)"

# Zsh
eval "$(tsctl completion zsh)"

# Fish
tsctl completion fish > ~/.config/fish/completions/tsctl.fish

Install

npm install -g @tsctl/cli

# or run without installing
npx @tsctl/cli init

Standalone binaries attached below (no runtime needed).

v0.2.1 — npm + Node.js compatibility

Fixes

• npm/npx compatibility: CLI now works with both npx @tsctl/cli (Node.js) and bunx @tsctl/cli (Bun)
• Package renamed to @tsctl/cli
• CLI bundled to plain JS for Node.js compatibility (no bun runtime required for npm users)
• Standalone binaries still available as GitHub release assets (no runtime needed at all)

Install

# npm
npm install -g @tsctl/cli

# npx (no install)
npx @tsctl/cli init

# bun
bunx @tsctl/cli init

# standalone binary (download from assets below)

See v0.2.0 release notes for the full feature changelog.

v0.2.0 — Typesense v30 Support

What's New

Typesense v30 Support

• Full backward compatibility with Typesense v27-v29
• Global Synonym Sets (replacing per-collection synonyms)
• Global Curation Sets (replacing per-collection overrides)
• Diversity/MMR support in curation items

New Resource Types

• Stopword Sets — manage search query stopwords
• Search Presets — reusable search parameter configurations
• Stemming Dictionaries — custom word-to-root mappings

Schema Enhancements

• geopolygon field type
• stem_dictionary, truncate_len field parameters
• Field-level token_separators and symbols_to_index
• Collection metadata and curation_sets linking
• Analytics rule source/destination params (v30 format)
• log analytics rule type

CLI Improvements

• tsctl plan --json — machine-readable plan output
• tsctl apply --target — selectively apply specific resources
• tsctl completion bash|zsh|fish — shell completions
• tsctl validate now shows all resource types
• tsctl import discovers all new resource types

Infrastructure

• GitHub Actions CI testing against both Typesense v27 and v30
• Docker Compose files for local development
• 267 integration tests across 19 test files
• Claude Code SKILL.md for AI-assisted infrastructure management

Drift Detection

• Detects unmanaged stopwords, presets, and curation sets
• Full lifecycle coverage for all resource types