start-fresh

Reset a Git workspace to main, pull latest changes, and remove merged branches.

1|1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/bruno-garcia/pi-config --skill start-fresh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: start-fresh
Source: https://github.com/bruno-garcia/pi-config/tree/main/skills/start-fresh
Command: npx skills add https://github.com/bruno-garcia/pi-config --skill start-fresh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill ensures a clean and up-to-date workspace, preventing conflicts and ensuring you start new tasks with the latest code and a clear overview of pending items.

Core Features & Use Cases

  • Workspace Reset: Switches to the main branch, pulls the latest changes, and cleans up old branches.
  • Uncommitted Change Check: Warns before proceeding if there are uncommitted changes, offering options to stash or abort.
  • Open Todo Review: Summarizes any outstanding tasks or todos to keep you informed.
  • Use Case: Before starting a new feature development or debugging session, run this Skill to ensure your local environment is pristine and synchronized with the main codebase.

Quick Start

Run the start-fresh skill to prepare your workspace for a new task.

Frequently Asked Questions about start-fresh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reset my Git workspace before starting a new task?

Reset your Git workspace by checking out the main branch, pulling the latest changes, and removing merged local branches. This Skill also warns about uncommitted changes and summarizes open todos for a clean development environment.

What happens to uncommitted changes when I clean up my Git workspace?

When cleaning up your Git workspace, the Skill warns about uncommitted changes before proceeding and offers options to stash or abort, ensuring no local work is lost during the branch reset process.

How can I remove merged local branches and pull the latest code?

Remove merged local branches and pull the latest code by checking out the main branch and executing a workspace reset. This synchronizes with the remote repository and deletes obsolete local branches.

Does resetting a Git workspace check for open todos or pending tasks?

Yes, resetting a Git workspace identifies and reports any open todos using a todo tool. This provides a summary of outstanding tasks so you stay informed before switching contexts or starting new development.

Why do I need to synchronize with the main branch before debugging?

Synchronizing with the main branch before debugging ensures a pristine local environment with the latest code, preventing merge conflicts and ensuring your bug reproduction reflects the current codebase state.

What is the best way to prepare a local development environment for a new feature?

The best way to prepare a local development environment is to run a workspace reset that switches to the main branch, pulls updates, removes old branches, and reviews pending todos for a clean start.