forgecad-project-sync

Synchronizes local ForgeCAD project folders with the hosted forgecad.io platform via CLI commands.

927|103|Updated Feb 8, 2026
One-click install
npx skills add https://github.com/KoStard/forgecad-public-kit --skill forgecad-project-sync
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forgecad-project-sync
Source: https://github.com/KoStard/forgecad-public-kit/tree/main/skills/forgecad-project-sync
Command: npx skills add https://github.com/KoStard/forgecad-public-kit --skill forgecad-project-sync

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeping local ForgeCAD project folders in sync with the hosted forgecad.io platform requires knowing which CLI command to run, when authentication is needed, and how content-hash-based sync behaves. This Skill encodes those operational rules so agents manage project sync correctly without relearning the command inventory.

Core Features & Use Cases

  • Project lifecycle management: Initialize projects with project init, clone remote projects with project clone, and keep them in sync with status, pull, and push.
  • Hosted file and sharing operations: Perform single-file operations via project file commands and publish live share links with publish.
  • Use Case: An agent edits a .forge.js model locally, runs forgecad project status to check content-hash differences, pushes the changes with --force for non-interactive automation, and publishes an updated share URL that always reflects the current file.

Quick Start

Ask the agent to initialize a new ForgeCAD project in the current folder and push it to the hosted platform using the forgecad CLI.

Frequently Asked Questions about forgecad-project-sync

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

FAQPage Schema
How do I sync a local ForgeCAD project with the hosted platform?

Run forgecad project status to compare content hashes, then forgecad project push to upload local changes or pull to download remote ones. The project folder must contain a forgecad.json file linking it to the hosted project.

How do I create a new hosted ForgeCAD project from the CLI?

Run forgecad project init "Name" inside the local folder. This creates the remote project, writes forgecad.json, and pushes existing local files. Use forgecad project clone <slug> for the inverse operation.

Does forgecad project push require authentication?

Yes, all project and publish commands require running forgecad login first. Local operations like run, render, and studio work without any authentication.

How does ForgeCAD detect which files changed during sync?

Sync is content-hash based: status, push, and pull compare file content hashes rather than timestamps or git history. A file counts as modified purely when its content differs.

Why does my published ForgeCAD share link show different content after pushing?

Published shares are live references to the current project file, not snapshots. Pushing changes silently updates every published model, so the share URL always displays the latest pushed content.

How do I run forgecad push without confirmation prompts in automation?

Pass the --force flag to skip confirmation prompts on push, pull, and delete commands. This is required for non-interactive agent automation runs.