Alexander Fuerst
FUERST.ONEAlexander FuerstUX+AI Engineer
Ask about availability ↗

Case study

ts-shove – AST Refactoring Skill for AI Coding Agents

By

Last updated:

A refactoring skill that gives AI coding agents a deterministic way to move TypeScript code.

Why an agent skill

ts-shove was built first as a tool for AI coding agents. An agent can decide how to restructure a codebase, then express the operation through an explicit batch manifest instead of repairing every import with ad hoc text edits. The owner uses it actively and reports that it makes TypeScript file moves much easier.

AST-backed batch moves

The engine uses ts-morph and the selected tsconfig to analyse module relationships. It supports file and directory moves, re-exports, dynamic imports and require calls. Alias behavior is configurable: preserve existing aliases, prefer aliases when possible, or use relative paths. Dry-run conflict checks and Git integration make the intended changes inspectable. The same engine is available through a CLI and a programmatic API.

The inspected local April 2026 revision also renames type aliases, variables, classes, enums and interfaces and updates project references, with renames applied before moves. This addition is ahead of public GitHub main and npm 1.0.0, which retain the March 2026 file-moving scope.

Contribution and delivery

The owner records a one-person human team, an open-source project and evenings/weekends work. All seven local commits are attributed to Alexander Fuerst. Git and corroborating file metadata place the observed implementation window between 25 March and 17 April 2026; the owner confirmed Git’s year. The tool remains in active internal use with occasional maintenance. The last implementation commit does not mark retirement.

The reported benefit is easier, more repeatable file moves for the owner’s coding agents through AST-based batches and configurable import handling. This is a qualitative owner report; there is no measured time-saving baseline or external adoption count. Separately, all 254 existing regression tests passed across library and scoped CLI checks on a temporary copy of the inspected local revision.

Scope limits

The agent chooses the refactoring; ts-shove executes deterministic structural edits without embedding model inference. Only files included by the chosen tsconfig are analysed. Runtime-computed paths and CSS/SCSS import rules are outside the documented scope. Replacement effort and complexity remain explicitly labelled analyst judgments.

Sources

Owner statements and Notion selections, 17 November 2026. Repository: https://github.com/fuerst-one/ts-shove . Package: https://www.npmjs.com/package/ts-shove . Public main: 3416fa67f744400b735e6352348ea47f0cc010b8. Inspected local HEAD: 90f64285f1564dd965a9dadec986e2d3cbcc48cd.