Tasks Sync

Sync Tasks to Project

Sync all tasks from the current session to projects/$ARGUMENTS/tasks/{session-id}/.

This skill is for manual syncing when work started without setting an active project. Once synced, the automatic hook handles future task updates.

Process

Step 1: Validate Project

Check if the project directory exists:

ls -d projects/$ARGUMENTS 2>/dev/null

If the project doesn't exist, ask: "Project '$ARGUMENTS' doesn't exist. Create it?"

If yes, create the project structure:

mkdir -p projects/$ARGUMENTS/tasks

Step 2: Determine Session ID

Find the current session by looking for the most recently modified task directory:

ls -dt ~/.claude/tasks/*/ 2>/dev/null | head -1 | xargs basename

If no session found, use a timestamp-based identifier:

echo "manual-$(date +%Y%m%d-%H%M%S)"

Store the session ID for use in subsequent steps.

Step 3: Set Active Project

Create/update the active project marker:

echo "$ARGUMENTS" > .claude-active-project

Step 4: Get Current Tasks

Use TaskList to get all tasks in the current session.

Step 5: Sync Each Task

For each task from TaskList:

1. Use TaskGet to get full task details
2. Create the session directory:

mkdir -p projects/$ARGUMENTS/tasks/{session-id}

3. Create a JSON file with the task data:

{
  "id": "<task-id>",
  "subject": "<subject>",
  "description": "<description>",
  "activeForm": "<activeForm>",
  "status": "<status>",
  "blocks": [],
  "blockedBy": []
}

4. Write to projects/$ARGUMENTS/tasks/{session-id}/<id>.json

Step 6: Stage for Git

git add projects/$ARGUMENTS/tasks/{session-id}/*.json

Step 7: Report

Synced X tasks to projects/$ARGUMENTS/tasks/{session-id}/
- Pending: Y
- In Progress: Z
- Completed: W

Files staged for commit. Run /git-commit when ready.

Notes

• This skill manually syncs all current tasks to a project
• Use this when work started without a project context
• After syncing, the active project is set so future tasks auto-sync via the hook
• Each sync creates a new session directory to preserve history