Vibe coding level:

You don't think of yourself as a "builder" but you'd like to become one. You want to move from "just talking in meetings" to actually building real software. The terminal is a terrifying black box.

Glossary

Plain-English definitions for the words you’ll meet while building.

Agent
An AI helper that does the actual building, writing and changing your software based on what you ask for.A Claude Code session running against your project, with tools to read, write, and run code.
BYOK (Bring Your Own Key)
Using your own AI account key so you pay the AI provider directly for what you use.Bring Your Own Key: you supply an Anthropic API key and are billed by Anthropic for usage.
Branch
A safe copy of your project to experiment in, so your main version stays untouched until you're ready.A named pointer to a line of commits; Sparkle creates one per agent so work stays isolated.
Claude Code
Anthropic's AI coding tool that normally runs in the terminal. Sparkle wraps it in a friendly desktop app.Anthropic's agentic CLI coding tool; Sparkle is a native desktop client on top of it.
Commit
A saved snapshot of your work with a short note about what changed.An immutable snapshot in git history, identified by a SHA.
DMG
The file you download to install a Mac app. You open it and drag Sparkle into your Applications folder.A macOS disk image: the standard way Mac apps are distributed and installed.
Git
A system that saves snapshots of your project so you can undo mistakes and track every change over time.Distributed version control. Sparkle drives it for you so you rarely run git commands by hand.
Merge
Combining the changes from a branch back into your main project.Integrating one branch's commits into another.
Model
The specific AI brain doing the work. More capable models are smarter but cost more per use.The underlying LLM (e.g. Claude Opus, Sonnet, Haiku) the agent runs on.
Parallel agents
Running more than one AI helper at the same time, each on its own task.Concurrent agents, each isolated in its own worktree and branch so they never collide.
Project
One app or piece of software you're building in Sparkle. Each project has its own files and agents.A workspace bound to one repository, with its own agents and settings.
Pull Request (PR)
A request to merge your changes into the main project, a checkpoint where you review everything before it becomes official.A GitHub pull request; Sparkle can open one from a branch in a click.
Repository (repo)
The folder that holds all your project's files and its complete history of changes.A git repository: your project plus its full version history.
Terminal
A text-only window where you type commands instead of clicking buttons. Sparkle means you almost never have to use it.The shell (zsh/bash) where command-line tools run.
Worktree
A separate workspace where one AI agent can work without bumping into the others.A git worktree: a checked-out branch in its own directory; Sparkle gives each agent one.