Skip to main content
Rename an existing .linktrail/ directory to .agentlinkops/. This renames the legacy ledger directory. It refuses conflicting directories and a legacy sync.lock; keep your records intact and review the receipt.

​
Example

Renames an existing legacy ledger directory and prints a receipt, or reports that the current directory is already in use. It refuses conflicting directories and a legacy sync.lock marker; it does not assess a website URL migration.

​
Options

--json prints the receipt as JSON.

​
Exit status

0 on success or when .agentlinkops/ is already in use; 2 on usage, lock or directory conflicts.

​
What happens

Finds .linktrail/ at or above the current directory and renames it to .agentlinkops/ with one rename call. Nothing is merged, copied, deleted or rewritten. Refuses when .agentlinkops/ already exists, when no .linktrail/ exists (a no-op exit 0 when .agentlinkops/ is already in use), or when .linktrail/sync.lock is present. Prints a receipt listing every moved file and a reminder to update .gitignore, CI and scripts that name the old directory. Until you run it, the CLI reads an existing .linktrail/ with one hint per process; that read-through ends at the DP-0029-T05 cutover.
Read configuration and file ownership for environment variables, compatibility aliases and writer locks. Read local file contracts for artifact fields. Browse the CLI index for related commands.
Check the selected environment and workspace access before calling hosted operations. See capability status.