sync

User Input

$ARGUMENTS

$ARGUMENTS can optionally specify:

• --dry-run -- show what would change without making updates
• --epic {name} -- sync a specific epic (default: active)

Setup

1. Read .coco/config.yaml for issue_tracker configuration.
2. If issue_tracker.provider is "none", report "No issue tracker configured" and exit.

Execution

0. Clean Up Stale Worktrees

Remove stale git worktree references left by crashed or completed agents:

git worktree prune

If .claude/worktrees/ contains directories with no corresponding git worktree, remove them:

git worktree list --porcelain

Compare against directories in .claude/worktrees/. Remove any orphaned directories.

1. Load Tracker State

coco-tracker list --json --epic {epic-id}

Parse all tasks with their statuses and issue_key metadata.

2. Load Issue Tracker State

For each tracker task that has an issue_key:

If "linear":

Use: mcp__plugin_linear_linear__get_issue
Parameters:
  id: {issue_key}

If "github":

If github.use_projects is true:

1. Read .coco/state/gh-projects.json and find the feature entry where project_number matches the task's gh_project_number metadata. Extract project_id, status_field_id, and status_options from that entry.
2. Query project board status as source of truth:

   gh project item-list {project_number} --owner {github.owner} --format json
   

   Match each task's gh_project_item_id to get its current board column status.
3. Backfill detection: For tasks with issue_key but no gh_project_item_id (pre-existing issues created before Projects V2 was enabled), offer to backfill:

   gh project item-add {project_number} --owner {github.owner} --url {issue_url}
   

   Then update tracker metadata with the new gh_project_item_id.

If github.use_projects is false (legacy):

gh issue view {issue_number} --json state,labels