sprk — SparkLabs CLI

The official command-line tool for SparkLabs — a friendly git wrapper with a clean interface and plain-English output.

Install

npm install -g sparkdev

That's it. The sprk command is now available globally.

Quick Start

# Create a new repository
sprk init

# Stage your files
sprk add .

# Save your changes
sprk commit -m "first save"

# Sync to the cloud vault
sprk push

All Commands

Repository

| Command | Description | |---|---| | sprk init | Create a new SparkLabs repository | | sprk clone <url> | Clone a remote repository |

Changes

| Command | Description | |---|---| | sprk status | Show what files have changed | | sprk diff | Show exact line-by-line changes | | sprk add <file\|.> | Stage a file (or all files) to be saved | | sprk unstage <file> | Remove a file from the staging area | | sprk restore <file> | Discard changes in a file |

Saving & Syncing

| Command | Description | |---|---| | sprk commit -m "msg" | Save staged changes with a description | | sprk push | Sync your saves to the cloud vault | | sprk pull | Get the latest changes from the cloud vault | | sprk fetch | Download remote info without merging |

History

| Command | Description | |---|---| | sprk log | View save history | | sprk log --oneline | Compact one-line save history | | sprk show <hash> | Inspect a specific saved change |

Branches

| Command | Description | |---|---| | sprk branch | List all branches | | sprk branch <name> | Create a new branch | | sprk checkout <name> | Switch to a branch | | sprk checkout -b <name> | Create and switch to a new branch | | sprk merge <name> | Merge a branch into the current one | | sprk branch -d <name> | Delete a branch (safe) |

Stashing

| Command | Description | |---|---| | sprk stash | Temporarily hide your changes | | sprk stash pop | Bring back hidden changes | | sprk stash list | List all stashed change sets | | sprk stash drop | Throw away the most recent stash |

Undoing

| Command | Description | |---|---| | sprk revert HEAD | Undo the last save | | sprk revert <hash> | Undo a specific past save | | sprk reset --soft HEAD~1 | Unsave last commit, keep changes staged |

Remotes

| Command | Description | |---|---| | sprk remote -v | Show connected remote vaults | | sprk remote add <n> <url> | Connect a new remote vault | | sprk remote remove <n> | Disconnect a remote vault |

Tags & Releases

| Command | Description | |---|---| | sprk tag | List all release tags | | sprk tag <v1.0.0> | Create a release tag | | sprk push --tags | Push all tags to remote |

Notes

• sprk is a wrapper around git. All standard git flags are passed through.
• Requires git to be installed on your machine.
• Requires Node.js ≥ 16.

Platform Support

| Platform | Supported | |---|:---:| | Linux | ✅ | | macOS | ✅ | | Windows | ✅ |

Uninstall

npm uninstall -g sparkdev

Links

• 🌐 Platform: lab.sparkdev.in
• 📦 npm: npmjs.com/package/sparkdev
• 🐛 Issues: github.com/sparkdev-in/sprk/issues

Built with ⚡ by the SparkLabs team