> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentlinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# agentlinkops migrate

> Rename an existing .linktrail/ directory to .agentlinkops/.

```bash theme={null}
agentlinkops migrate
```

## Behavior and output

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.

## Arguments

\--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.

Read [configuration and file ownership](/reference/local/configuration) before automating this command. Read [local file contracts](/reference/local/artifacts) for artifact fields. Browse the [local command index](/reference/local/index) for related commands.

<Note>Check the selected environment and workspace access before calling hosted operations. See [capability status](/capability-status).</Note>