skills.rest
BekaChkhiro
BekaChkhiroCOMMUNITY
Explore all skills by this author →
GitHub

pfSyncPush

Push local PROJECT_PLAN.md to PlanFlow cloud via API.

1|Updated Jan 26, 2026
Search Tags:#automation#API#cloud#jq#curl#project-sync#planflow
One-click install
npx skills add https://github.com/BekaChkhiro/claude-plan-plugin --skill pfsyncpush
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pfSyncPush
Source: https://github.com/BekaChkhiro/claude-plan-plugin/tree/main/commands/pfSyncPush
Command: npx skills add https://github.com/BekaChkhiro/claude-plan-plugin --skill pfsyncpush

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq.

What problem does it solve?

This Skill enables you to push your local PROJECT_PLAN.md to PlanFlow cloud, ensuring your project plan stays in sync with the cloud and reflects the latest changes.

Core Features & Use Cases

  • Cloud sync: Push the locally authored PROJECT_PLAN.md to the PlanFlow service, creating or updating the cloud plan.
  • Deterministic updates: Supports a force option to overwrite cloud state and ensures the local plan remains the source of truth.
  • Error handling & feedback: Validates authentication, linked project, and network responses, and reports task counts and progress after push.

Quick Start

Run /pfSyncPush to push your local PROJECT_PLAN.md to PlanFlow.

  • Ensure you have a valid PlanFlow cloud configuration in ~/.config/claude/plan-plugin-config.json and a linked PlanFlow project.
  • Place PROJECT_PLAN.md in the repository root.
  • Execute /pfSyncPush to perform the sync.

Frequently Asked Questions about pfSyncPush

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I push a local PROJECT_PLAN.md to PlanFlow cloud?▼

To push a local PROJECT_PLAN.md to PlanFlow cloud, run /pfSyncPush. It uses curl and jq to build the payload and call the API, requiring a valid API token and projectId in your local cloud configuration.

Can I overwrite the cloud project plan using a force update?▼

Yes, you can overwrite the cloud project plan by using the force update option. This ensures your local PROJECT_PLAN.md remains the deterministic source of truth and overwrites the existing cloud state during the sync.

Do I need curl and jq installed to sync project plans to PlanFlow?▼

Yes, you need curl and jq installed to sync project plans to PlanFlow. These standard command-line tools are required dependencies used to construct the API payload and execute the network request.

What configuration is required before syncing a project plan to the cloud?▼

Before syncing a project plan to the cloud, you need a PlanFlow configuration file at ~/.config/claude/plan-plugin-config.json containing your API token and projectId, along with a PROJECT_PLAN.md file placed in your repository root.

Does the PlanFlow sync process validate authentication and handle API errors?▼

Yes, the PlanFlow sync process validates authentication, checks the linked project, and handles network responses. It provides error feedback and reports task counts and progress after the push completes.

Related Skills

Explore More Product & Management Skills→
BekaChkhiroBekaChkhiro
1

pfLogin

Authenticate PlanFlow accounts and store session tokens in config files.

Community
Intermediate
BekaChkhiroBekaChkhiro
1

pfCloudUnlink

Disconnect local configuration from the active PlanFlow cloud project.

Community
Basic
BekaChkhiroBekaChkhiro
1

pfSyncPull

Pulls PlanFlow cloud plan into local PROJECT_PL.md via authenticated API request.

Community
Intermediate
BekaChkhiroBekaChkhiro
1

pfCloudNew

Create cloud PlanFlow projects from local plans or project names.

Community
Intermediate