new

Create a new change (similar to a commit in Git) based on one or more parent changes.

This command is used when you’re ready to start working on something new after completing your current work. It creates a fresh change that builds upon the specified parent(s).

Key behaviors:

• If no parents specified, uses the current change as parent
• Automatically switches to the new change after creation
• The previous change becomes read-only to preserve history
• Multiple parents create a merge (combining work from different branches)

Typical workflow:

1. Describe your planned changes with ‘pogo describe’
2. Make your code changes
3. Push regularly with ‘pogo push’ to save your work
4. When done, create a new change with ‘pogo new’ to start fresh

Usage

pogo new

Flags

• --description, -m : Description for the new change

Examples

# Create a new change from the current change
pogo new

# Create a new change with a description
pogo new -m "feat: implement user profiles"

# Create a new change from a specific parent
pogo new happy-mountain-7

# Create a merge change with multiple parents
pogo new feature-branch-1 feature-branch-2

# Create from a bookmarked change
pogo new main