Add AllTipsShownBehaviours to control tip display behavior when all tips have been shown by Copilot · Pull Request #153 · deadlydog/PowerShell.tiPS

Copilot · 2025-10-25T00:26:04Z

Adds a new AllTipsShownBehaviours enum that allows users to configure what happens when all tips have been shown - either clear the shown tips list and continue cycling, or stop showing tips automatically.

Changes

C# Enums and Configuration

Created new AllTipsShownBehaviours enum in Configuration.cs with values:
- ClearShownTipsList = 0 (default) - Clears the shown tips list and continues showing all tips in rotation
- DoNotShowTips = 1 - Stops showing tips automatically when all tips have been shown
Added AllTipsShownBehaviour property to the Configuration class

PowerShell Logic

Added TestIfUnseenTipsExist function that compares all tip IDs against TipIdsAlreadyShown.txt
Updated WriteAutomaticPowerShellTipIfNeeded to check AllTipsShownBehaviour after cadence evaluation
Added AllTipsShownBehaviour parameter to Set-TiPSConfiguration with updated help text and examples

Documentation

Updated ReadMe.md with a new "Show only unseen tips" subsection under "🤖 Automatic tip on PowerShell startup"
Added example showing how to configure the DoNotShowTips option
Documented available parameter values and behavior

Tests

Added tests for DoNotShowTips option behavior (shows tip when unseen tips exist, skips when all shown)
Added tests for TestIfUnseenTipsExist helper function

Design

This approach separates two orthogonal concerns:

Cadence (Never, EverySession, Daily, Weekly, Biweekly, Monthly) controls when to show tips
Behaviour (ClearShownTipsList, DoNotShowTips) controls what happens when all tips have been shown

This allows users to combine any cadence with the all-tips-shown behavior for maximum flexibility.

Usage

# Show tips daily, but stop showing them when all tips have been shown
Set-TiPSConfiguration -AutomaticallyWritePowerShellTip Daily -AllTipsShownBehaviour DoNotShowTips

# Show tips every session, clearing the shown tips list when all have been shown (default behavior)
Set-TiPSConfiguration -AutomaticallyWritePowerShellTip EverySession -AllTipsShownBehaviour ClearShownTipsList

Fixes Feature Request: Only display tip automatically when there is an unseen tip #152

Original prompt

Fixes Feature Request: Only display tip automatically when there is an unseen tip #152

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

deadlydog · 2025-10-27T20:22:52Z

src/CSharpClasses/tiPSClasses/Configuration.cs

 		Biweekly = 4,
-		Monthly = 5
+		Monthly = 5,
+		NewTipsOnly = 6


Instead of adding a NewTipsOnly value to this WritePowerShellTipCadence enum, please create a new WritePowerShellTipOptions enum with the values CycleThroughAllTips (default) and UnseenTipsOnly. Then add a new public WritePowerShellTipOptions AutoWritePowerShellTipOptions { get; set; } property to the Configuration class, and use that setting to determine if a tip should be automatically written or not.

@copilot please make these changes

Changes implemented in commit f3dcc9f.

Created a new WritePowerShellTipOptions enum with CycleThroughAllTips (default) and UnseenTipsOnly values, and added the AutoWritePowerShellTipOptions property to the Configuration class.

Users can now combine any cadence with the option, for example:

Set-TiPSConfiguration -AutomaticallyWritePowerShellTip Daily -AutomaticallyWritePowerShellTipOption UnseenTipsOnly

Screenshot showing the new enum and usage:

github-actions · 2025-10-27T20:46:45Z

Overall Project	91.35%	🍏

github-actions · 2025-10-27T20:47:14Z

Overall Project	91.35%	🍏

src/CSharpClasses/tiPSClasses/Configuration.cs

deadlydog · 2025-10-28T00:22:08Z

@copilot Also update the ReadMe.md to show an example of setting the AutoWritePowerShellTipOptions to OnlyShowUnseenTips.

github-actions · 2025-10-28T00:23:31Z

Overall Project	91.21%	🍏

github-actions · 2025-10-28T00:24:00Z

Overall Project	91.21%	🍏

Copilot · 2025-10-28T00:29:00Z

Added in commit 3a7dbf2.

Created a new subsection "Show only unseen tips" under the "🤖 Automatic tip on PowerShell startup" section with an example showing how to use the OnlyWriteUnseenTips option:

Set-TiPSConfiguration -AutomaticallyWritePowerShellTip Daily -AutomaticallyWritePowerShellTipOption OnlyWriteUnseenTips

The section also explains the available values and behavior of the option.

deadlydog · 2025-10-28T00:42:52Z

src/CSharpClasses/tiPSClasses/Configuration.cs

 		Random = 2
 	}

+	public enum WritePowerShellTipOptions


@copilot Rename the WritePowerShellTipOptions enum to WritePowerShellTipConditions and rename the AutoWritePowerShellTipOptions property to WritePowerShellTipCondition

Renamed in commit 60560a1.

The names are now:

Enum: WritePowerShellTipConditions

Property: WritePowerShellTipCondition

Updated all references across C# and PowerShell files, including tests.

github-actions · 2025-10-28T00:45:55Z

Overall Project	91.21%	🍏

github-actions · 2025-10-28T00:46:09Z

Overall Project	91.21%	🍏

github-actions · 2025-10-28T01:04:58Z

Overall Project	91.21%	🍏

Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

… cadence Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

…psOnly to OnlyWriteUnseenTips Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

…AutoWritePowerShellTipOptions to WritePowerShellTipCondition Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

…dition

github-actions · 2025-10-28T01:21:12Z

Overall Project	91.21%	🍏

deadlydog · 2025-10-28T01:29:12Z

src/CSharpClasses/tiPSClasses/Configuration.cs

 		Random = 2
 	}

+	public enum WritePowerShellTipConditions


@copilot Rename the WritePowerShellTipConditions enum to GetPowerShellTipConditions, and rename the WritePowerShellTipCondition class property to GetPowerShellTipCondition.

Renamed in commit daa49b7.

The names are now:

Enum: GetPowerShellTipConditions

Property: GetPowerShellTipCondition

Updated all references across C# files, PowerShell files, tests, and documentation.

… WritePowerShellTipCondition to GetPowerShellTipCondition Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

deadlydog · 2025-10-28T01:52:55Z

src/CSharpClasses/tiPSClasses/Configuration.cs

+	public enum GetPowerShellTipConditions
+	{
+		CycleThroughTips = 0,
+		OnlyWriteUnshownTips = 1


@copilot Rename the value OnlyWriteUnshownTips to OnlyGetUnshownTips

Renamed in commit 61fae99.

The enum value is now OnlyGetUnshownTips.

Updated all references across C# files, PowerShell files, tests, and documentation.

Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

deadlydog · 2025-10-28T02:27:08Z

src/CSharpClasses/tiPSClasses/Configuration.cs

 		Random = 2
 	}

+	public enum GetPowerShellTipConditions


@copilot Rename the GetPowerShellTipConditions enum to AllTipsShownBehaviours, rename the CycleThroughTips value to ClearShownTipsList, rename the OnlyGetUnshownTips value to DoNotShowTips, and rename the GetPowerShellTipCondition class property to AllTipsShownBehaviour.

Renamed in commit 73e2c88.

The names are now:

Enum: AllTipsShownBehaviours

Property: AllTipsShownBehaviour

Enum values: ClearShownTipsList and DoNotShowTips

Updated all references across C# files, PowerShell files, tests, and documentation.

…aviours, CycleThroughTips to ClearShownTipsList, OnlyGetUnshownTips to DoNotShowTips, GetPowerShellTipCondition to AllTipsShownBehaviour Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

Copilot AI assigned Copilot and deadlydog Oct 25, 2025

Copilot started work on behalf of deadlydog October 25, 2025 00:26 View session

Copilot AI changed the title ~~[WIP] Add NewTipsOnly setting to TipCadence enum~~ Add NewTipsOnly cadence for showing tips only when unseen tips exist Oct 25, 2025

Copilot AI requested a review from deadlydog October 25, 2025 00:36

Copilot finished work on behalf of deadlydog October 25, 2025 00:36

deadlydog reviewed Oct 27, 2025

View reviewed changes

Copilot started work on behalf of deadlydog October 27, 2025 23:25 View session

Copilot AI changed the title ~~Add NewTipsOnly cadence for showing tips only when unseen tips exist~~ Add WritePowerShellTipOptions to control showing unseen tips only Oct 27, 2025

Copilot AI requested a review from deadlydog October 27, 2025 23:32

Copilot finished work on behalf of deadlydog October 27, 2025 23:32

deadlydog reviewed Oct 28, 2025

View reviewed changes

src/CSharpClasses/tiPSClasses/Configuration.cs Outdated Show resolved Hide resolved

Copilot started work on behalf of deadlydog October 28, 2025 00:20 View session

Copilot finished work on behalf of deadlydog October 28, 2025 00:26

Copilot AI requested a review from deadlydog October 28, 2025 00:26

Copilot started work on behalf of deadlydog October 28, 2025 00:27 View session

Copilot finished work on behalf of deadlydog October 28, 2025 00:30

deadlydog reviewed Oct 28, 2025

View reviewed changes

Copilot started work on behalf of deadlydog October 28, 2025 00:43 View session

Copilot AI changed the title ~~Add WritePowerShellTipOptions to control showing unseen tips only~~ Add WritePowerShellTipConditions to control showing unseen tips only Oct 28, 2025

Copilot AI requested a review from deadlydog October 28, 2025 00:48

Copilot finished work on behalf of deadlydog October 28, 2025 00:48

Copilot AI and others added 8 commits October 27, 2025 19:14

Initial plan

a0f988b

Add NewTipsOnly cadence to WritePowerShellTipCadence enum

8d8483c

Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

Refactor to use WritePowerShellTipOptions enum instead of NewTipsOnly…

0817489

… cadence Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

Rename enum values: CycleThroughAllTips to CycleThroughTips, UnseenTi…

12ea78e

…psOnly to OnlyWriteUnseenTips Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

Add ReadMe example for OnlyWriteUnseenTips option

03f9323

Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

Rename WritePowerShellTipOptions to WritePowerShellTipConditions and …

7411dbf

…AutoWritePowerShellTipOptions to WritePowerShellTipCondition Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

Rename OnlyWriteUnseenTips to OnlyWriteUnshownTips

145851e

Rename AutomaticallyWritePowerShellTipOption to WritePowerShellTipCon…

432df06

…dition

deadlydog force-pushed the copilot/add-newtipsonly-setting branch from afb09f4 to 432df06 Compare October 28, 2025 01:19

deadlydog reviewed Oct 28, 2025

View reviewed changes

Copilot started work on behalf of deadlydog October 28, 2025 01:29 View session

Rename WritePowerShellTipConditions to GetPowerShellTipConditions and…

daa49b7

… WritePowerShellTipCondition to GetPowerShellTipCondition Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

Copilot AI changed the title ~~Add WritePowerShellTipConditions to control showing unseen tips only~~ Add GetPowerShellTipConditions to control showing unseen tips only Oct 28, 2025

Copilot AI requested a review from deadlydog October 28, 2025 01:34

Copilot finished work on behalf of deadlydog October 28, 2025 01:34

deadlydog reviewed Oct 28, 2025

View reviewed changes

Copilot started work on behalf of deadlydog October 28, 2025 01:53 View session

Rename OnlyWriteUnshownTips to OnlyGetUnshownTips

61fae99

Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

Copilot AI requested a review from deadlydog October 28, 2025 01:57

Copilot finished work on behalf of deadlydog October 28, 2025 01:57

deadlydog reviewed Oct 28, 2025

View reviewed changes

Copilot started work on behalf of deadlydog October 28, 2025 02:27 View session

Rename enum and values: GetPowerShellTipConditions to AllTipsShownBeh…

73e2c88

…aviours, CycleThroughTips to ClearShownTipsList, OnlyGetUnshownTips to DoNotShowTips, GetPowerShellTipCondition to AllTipsShownBehaviour Co-authored-by: deadlydog <1187140+deadlydog@users.noreply.github.com>

Copilot AI changed the title ~~Add GetPowerShellTipConditions to control showing unseen tips only~~ Add AllTipsShownBehaviours to control tip display behavior when all tips have been shown Oct 28, 2025

Copilot AI requested a review from deadlydog October 28, 2025 02:32

Copilot finished work on behalf of deadlydog October 28, 2025 02:32

Uh oh!

Conversation

Copilot AI commented Oct 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changes

Design

Usage

Comments on the Issue (you are @copilot in this section)

Uh oh!

deadlydog Oct 27, 2025

Choose a reason for hiding this comment

Uh oh!

deadlydog Oct 27, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 27, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Oct 27, 2025

Uh oh!

github-actions bot commented Oct 27, 2025

Uh oh!

Uh oh!

deadlydog commented Oct 28, 2025

Uh oh!

github-actions bot commented Oct 28, 2025

Uh oh!

github-actions bot commented Oct 28, 2025

Uh oh!

Copilot AI commented Oct 28, 2025

Uh oh!

deadlydog Oct 28, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 28, 2025

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Oct 28, 2025

Uh oh!

github-actions bot commented Oct 28, 2025

Uh oh!

github-actions bot commented Oct 28, 2025

Uh oh!

github-actions bot commented Oct 28, 2025

Uh oh!

deadlydog Oct 28, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 28, 2025

Choose a reason for hiding this comment

Uh oh!

deadlydog Oct 28, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 28, 2025

Choose a reason for hiding this comment

Uh oh!

deadlydog Oct 28, 2025

Choose a reason for hiding this comment

Uh oh!

Copilot AI Oct 28, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Copilot AI commented Oct 25, 2025 •

edited

Loading