📦
Workflow 01
Project Snapshot
Zip a project for safe rollback. Detects the kind
(Unity / Xcode / Node / Rust / Python / Godot) and excludes
its derived paths (Library/, node_modules/,
target/, etc.) so the archive isn't bloated by
caches. Refuses backups to NAS drives — those have
edge cases we'll handle in v1.1. ZIP or TAR.GZ; archive
name carries date + project name; final summary shows
files / source size / archive size / saved %.
🔍
Workflow 02
Project Detector
Find every project under one or more folders. Walks 4
levels deep, skips noise (node_modules/,
.git/, DerivedData/),
and surfaces a sorted-by-size list with kind badges. Smart
matcher links loose files to the right project via
filename token overlap (CamelCase aware) plus
kind-affinity tie-breaking — .unitypackage
prefers Unity, .xib prefers Xcode, etc. Pop
the manual picker for anything the auto-matcher misses.
📥
Workflow 03
Stage & Import
Copy a loose file into a project's safe folder. Per-kind
subfolder suggestions — Unity images go to
Assets/Art/Imports/, Xcode resources to
Resources/Imports/, Node code to
src/imports/. Refuses to
write into derived paths or managed config files — your
editor's regenerated folders stay untouched. Recent
Projects are remembered so you don't fish through folder
pickers.
🔄
Workflow 04
GitHub Sync
Safe-by-default git Sync (fetch + --ff-only
pull, auto-stash dirty work first) and Commit & Push
with a file checklist + commit-message editor.
Never uses --force,
--hard, or rebase. Refuses to
operate during in-progress merge / rebase / cherry-pick —
resolve in your editor first. Live log shows every
command run with the actual stdout / stderr.
➕
Workflow 05
Init Repo
Turn a folder into a git repository. Editable
.gitignore seeded for the detected project
kind (Unity / Xcode / Node / Rust / Python / Godot
templates built in). First-commit message field.
Optional GitHub remote URL — adds origin
without pushing so you can verify before publishing.
Refuses to init folders that already have .git/.
✨
Workflow 06
Git Full Run
End-to-end wizard: pre-flight → init (if no
.git/) → set GitHub remote → verify it
exists (clear guidance + link to github.com/new
when it doesn't) → commit & push. Accepts
user/repo shorthand or full SSH / HTTPS URLs.
Detects when HTTPS auth is the problem and one-click
swaps to the SSH equivalent.