Skip to content

Glossary

TheFactoryGuy edited this page Oct 31, 2026 · 2 revisions

The words you come across in Coodoo, in plain language.

Coodoo uses GitHub's real words, so you recognise them on GitHub itself. When a word has a dotted line under it, hover over it or click it for a short explanation. Under Settings → General → Explaining GitHub terms you choose how much explanation you see: with Beginner there is always a short line of explanation under buttons and tabs, with Advanced only the term itself.

Coodoo made up two words itself: Promote and Back-merge. They are marked Coodoo word, and they say what Coodoo does on GitHub for them.

Commit

A saved step in your code's history, with a short description of what changed. You can always look back at what was in a commit, and go back to it if needed.

Compare it to: a save point in a game.

Push

Sending your commits from this computer to GitHub. Only then are they online too, where others (and the autopilot on another computer) can see them.

Compare it to: uploading the photos on your phone to the cloud.

Pull

Bringing the latest work from GitHub to this computer. Do this before you carry on, so you don't build on an old version.

Compare it to: refreshing a shared document to see the latest version.

Merge

Putting the work from one branch into another branch, so they are one whole again. When two changes clash, you get a conflict.

Compare it to: combining two versions of a recipe into one recipe with all the improvements.

Branch

A separate version of your code, so work in progress doesn't touch your main version. When the work is done, you merge the branch back.

Compare it to: a copy of a document where you can try things freely while the original stays intact.

Pull request

A request on GitHub to merge the work from one branch into another branch. That way the work can be looked at and checked first, for example by checks.

Compare it to: a proposal you hand in for approval before it goes ahead.

Repository

A project on GitHub, with all its code and its whole history. Often shortened to repo.

Compare it to: a project folder that also keeps every earlier version.

Fork

Your own copy of someone else's repository, under your own GitHub account. You can work in it freely without touching the original.

Compare it to: copying a recipe from a cookbook into your own notebook so you can change it.

Tag

A fixed label on one commit, usually a version number like v1.2.0. A tag doesn't move.

Compare it to: a bookmark with a name on it in a book.

Release

A published version of your app on GitHub, with a tag, a description and optionally files to download. See also Release.

Compare it to: a new edition of a book that goes on sale.

GitHub Pages

A free GitHub service that puts a website online straight from your repository.

Compare it to: a shop window: what you set out in the repository is there for everyone to see.

Uncommitted changes

Changes in your files that have not been saved in a commit yet. They are only on this computer.

Compare it to: progress in a game since your last save point: not kept yet.

Behind / Ahead

How many commits a branch is behind or ahead of another branch or GitHub. When you are behind, you pull; when you are ahead, you push.

Compare it to: two people reading the same book: one is a few chapters further than the other.

Conflict

Two changes touch the same lines and git doesn't know which one to keep, so someone has to choose. Coodoo helps you with that.

Compare it to: two people each rewriting the same sentence in a document differently at the same time.

Protected branch

A branch that GitHub guards with rules, for example that work may only go in through a pull request, or only once the checks pass.

Compare it to: a safe you may only put things in with permission.

Checks

Automatic checks on GitHub, like tests and a build, that run for a commit or pull request. Green means everything went well.

Compare it to: a car inspection: only when everything passes may it go on the road.

Promote

Coodoo word. Moving the work on a branch one step further, to the next branch in your project's flow (for example from development to main).

On GitHub: Coodoo makes a pull request to the next branch and merges it.

Compare it to: a draft that becomes the official version once it is approved.

Back-merge

Coodoo word. Bringing work that is already on a later branch in the flow, but not yet on the branch before it, back to that earlier branch.

On GitHub: Coodoo makes a pull request from the later branch to the branch before it and merges it.

Compare it to: a correction made straight in the printed version that you then copy into the draft as well.

Other words

Word Meaning
Agent An AI that does work on its own. In Coodoo: Claude Code and Codex
API A way for programs to talk to each other
Autopilot The part of Coodoo that works through the goals on its own
Build Turning your code into a working program
Changelog A list of what changed in each version (CHANGELOG.md)
CLI A program you use from the command line, like Claude Code and Codex
Compacting An agent summarizes its conversation when its memory gets full
Context window How much text an agent can take in at once
Dependabot A GitHub service that tells you when parts of your project have known security holes
.env A file with your app's secret settings, like passwords and keys. Never belongs in git
Failsafe A fixed safety rule that Coodoo always enforces
Flow The fixed order of branches that work goes through to your live version, for example development → main
git The system that keeps track of your code's history
GitHub The website where your code lives online
Goal Something you want built; it gets split into tasks
Issue A report or request on GitHub; it can become a goal
MCP A standard for giving an agent extra tools
Plugin A package of extra skills for an agent
Project map A map of your code, for you and the agents
Project vault Encrypted storage for keys that Coodoo needs
Queue The goals still to be done, in order
Review Another agent checking the work
Semgrep A scanner that searches code for known bad patterns
Task One step from a goal's plan
Team memory The team's notes in the .coodoo/ folder
Token (1) A piece of text that AI calculates in: usage is measured in tokens. (2) A key that gives access to something, like your GitHub token
Vault See Project vault

Clone this wiki locally