@tanstack/ai-code-mode-snippets weekly downloads statistics

@tanstack/ai-code-mode-snippets

Persistent snippet library for TanStack AI Code Mode - LLM-created reusable code snippets.

Overview

The Snippets System extends Code Mode with persistent, LLM-creatable reusable code snippets. Snippets are TypeScript functions that the LLM can create, catalog, and invoke across sessions—enabling compounding capability over time.

Installation

Usage

Testing

This package includes a CLI for testing the snippets system. The tests verify the complete snippets lifecycle:

1. First run (Snippet Creation): LLM uses execute_typescript to solve a problem and registers a reusable snippet 2. Second run (Snippet Reuse): LLM calls the saved snippet directly without needing execute_typescript

Running the Simulated Test

The simulated test uses a mock adapter with predetermined responses for fully deterministic testing. No API key required.

Running the Live Test

The live test uses a real LLM (OpenAI or Anthropic) to verify the snippets flow with actual LLM responses.

Setup

1. Copy the environment example file:

2. Edit test-cli/.env.local and add your API key:

Run the test

CLI Commands

API Reference

codeModeWithSnippets(options)

Creates Code Mode tools and system prompt with snippets integration.

Options:

• config - Code Mode tool configuration (driver, tools, timeout, memoryLimit) • adapter - Text adapter for snippet selection (should be a cheap/fast model) • snippets.storage - Snippet storage implementation • snippets.maxSnippetsInContext - Maximum snippets to load into context (default: 5) • messages - Current conversation messages • snippetsAsTools - Whether to include snippets as direct tools (default: true)

Returns:

• toolsRegistry - Mutable ToolRegistry containing execute_typescript, snippet management tools, and selected snippet tools • systemPrompt - System prompt documenting available snippets and external functions • selectedSnippets - Snippets that were selected for this request

Storage

The worker/browser-safe in-memory storage (createMemorySnippetStorage) is re-exported from the root entry. The Node-only file storage (createFileSnippetStorage) imports node:fs / node:path, so it is only available from the /storage subpath — keeping the root export safe to import from Cloudflare Workers and browser bundlers:

createFileSnippetStorage(options)

Git-friendly file-based storage:

createMemorySnippetStorage(options)

In-memory storage for testing.

Trust Strategies

Snippets track execution success and promote trust levels over time:

| Trust Level | Description |

| untrusted | Newly created, not yet proven | | provisional | 10+ executions with ≥90% success | | trusted | 100+ executions with ≥95% success |

Available strategies:

• createDefaultTrustStrategy() - Earn trust through successful executions • createAlwaysTrustedStrategy() - Trust immediately (dev/testing) • createRelaxedTrustStrategy() - Faster promotion • createCustomTrustStrategy(options) - Custom thresholds

License

MIT

Description from the npm listing.