Skip to main content

Version Control

Codeezly has built-in version control with commits, branches, and full GitHub integration. Never lose work and easily manage multiple feature tracks.


Automatic Checkpoints

Every time the AI generates code, an automatic checkpoint (commit) is created. This means:

  • Every generation creates a revertible snapshot.
  • You can go back to any previous state of your project.
  • No changes are ever permanently lost.

Manual Commits

You can also create manual commits to checkpoint your work:

  1. Open the Version Control panel in the workspace sidebar.
  2. Review the changed files in the diff viewer.
  3. Enter a commit message describing your changes.
  4. Click Commit.

Viewing History

The commit timeline shows all commits in reverse chronological order:

  • Commit message — What changed (auto-generated or manual).
  • Timestamp — When the commit was created.
  • File diff — Click a commit to see exactly what files changed and how.
  • Restore — Click "Restore" on any commit to revert your project to that state.

Branches

Branches let you work on different features without affecting the main version:

  1. Click Create Branch in the version control panel.
  2. Name your branch (e.g., feature/dark-mode).
  3. Work on your changes in the branch — the main branch stays untouched.
  4. When ready, merge the branch back into main.

GitHub Integration

Connect your GitHub account to push your Codeezly project to a GitHub repository:

  1. Open the workspace for the project you want to sync.
  2. Open the Version Control panel.
  3. Use the GitHub button in the panel toolbar to authorize the Codeezly GitHub app.
  4. Push the current branch, pull remote changes, or create a pull request once the repository is linked.

Pull Requests

Codeezly can create pull requests on your behalf:

  • Work on a branch in Codeezly.
  • Click Create Pull Request in the GitHub panel.
  • Fill in the PR title and description.
  • The PR appears on GitHub ready for review and merge.

Two-Way Sync

Changes pushed from Codeezly appear on GitHub, and changes pushed to GitHub from other tools can be pulled back into Codeezly. This lets you use Codeezly alongside VS Code, IntelliJ, or any other editor.

Best Practices

  1. Commit often: Small, focused commits make it easy to isolate and revert specific changes.
  2. Use descriptive messages: Write commit messages that explain why a change was made, not just what was changed.
  3. Branch for experiments: Try risky ideas on a branch. If they don't work out, delete the branch instead of reverting.
  4. Push to GitHub regularly: Having a remote backup protects your work and enables collaboration.