Skip to main content

​
Synopsis

profclaw sync <subcommand> [flags]

​
Description

sync orchestrates cross-platform synchronization between profClaw and connected integrations (GitHub, Jira, Linear). It pulls new tickets and issues into the profClaw task queue, pushes status updates back to the source, and keeps bi-directional state in sync.

​
Subcommands

SubcommandDescription
allSync all configured integrations
github [repo]Sync GitHub issues (all repos or a specific one)
jira [project]Sync Jira tickets (all projects or a specific one)
linear [team]Sync Linear issues (all teams or a specific one)
statusShow last sync time and result for each integration

​
sync all

​
--dry-run
boolean
Show what would be synced without making changes.
​
--json
boolean
Output sync results as JSON.

​
sync github [repo] / sync jira [project] / sync linear [team]

​
--dry-run
boolean
Preview changes without applying them.
​
--force
boolean
Force a full resync even if items appear unchanged.
​
--limit
string
default:"100"
Maximum items to sync per integration.
​
--json
boolean
Output as JSON.

​
Examples

profclaw sync all

​
Sync Configuration

Configure sync behavior per integration in config/settings.yml: 
sync:
  github:
    enabled: true
    label: "profclaw"        # Only sync issues with this label
    autoCreateTasks: true    # Auto-create agent tasks for new issues
  jira:
    enabled: true
    projects: ["ENG", "OPS"]
    stateMapping:
      "Todo": pending
      "In Progress": in_progress
  linear:
    enabled: true
    autoAssign: true