carta-cli

What problem does it solve?

It solves the pain of reorganizing large, hierarchical documentation sets while keeping numeric references and manifests consistent, so you don’t end up with broken links or stale workspace indexes.

Core Features & Use Cases

• Deterministic structural operations for .carta workspaces: create, move, delete, punch (file-to-folder), and flatten directory trees while preserving or updating doc references correctly.
• Automatic ref renumbering and workspace regeneration: rewrites internal docXX.YY refs after renumbering and rebuilds MANIFEST.md so discovery stays accurate.
• Bulk-safe workflows and repair tools: supports dry runs, deletion output mapping for later rewrites, and a rewrite command to fix stale refs after restores.

Example use case: You inherited a workspace where sections were shuffled and references are now inconsistent; you can restructure using move/delete with gap-closing, then run rewrite based on captured mappings to repair any stale references across the workspace.

Quick Start

Have the agent perform the structural change by running the carta command: move doc04.05 doc04 --order 2 --dry-run.