ktsu.SingleAppInstance 1.3.1
ktsu.SingleAppInstance
A .NET library that ensures only one instance of your application is running at a time.
Introduction
ktsu.SingleAppInstance is a lightweight .NET library that provides a robust mechanism to ensure only one instance of an application is running at a time. It uses a JSON-serialized PID file with multi-attribute process verification to accurately detect running instances, making it ideal for desktop applications, services, or any software that requires instance exclusivity to prevent resource conflicts or maintain data integrity.
Features
- Single Instance Enforcement: Prevents multiple copies of your application from running simultaneously
- Enhanced Process Identification: Verifies running instances using multiple attributes (PID, process name, start time, executable path) for accurate detection
- Race Condition Handling: Includes a built-in 1-second delay to safely detect simultaneous startup attempts
- PID File Management: Stores process information as JSON in the application data directory
- Backward Compatibility: Gracefully handles legacy PID files that stored only a plain integer PID
- Simple API: Two methods —
ExitIfAlreadyRunning()for automatic exit andShouldLaunch()for custom logic - Multi-Target Support: Works across .NET 10.0 through .NET 5.0, .NET Standard 2.0/2.1
Installation
Package Manager Console
Install-Package ktsu.SingleAppInstance
.NET CLI
dotnet add package ktsu.SingleAppInstance
Package Reference
<PackageReference Include="ktsu.SingleAppInstance" Version="x.y.z" />
Usage Examples
Basic Example
The simplest way to use SingleAppInstance is to call ExitIfAlreadyRunning at the start of your application. If another instance is detected, the process exits automatically:
using ktsu.SingleAppInstance;
class Program
{
static void Main(string[] args)
{
SingleAppInstance.ExitIfAlreadyRunning();
// Your application code here
Console.WriteLine("Application is running.");
}
}
Custom Launch Logic
If you prefer to handle the duplicate-instance case yourself, use ShouldLaunch() which returns a boolean:
using ktsu.SingleAppInstance;
class Program
{
static void Main(string[] args)
{
if (SingleAppInstance.ShouldLaunch())
{
// Your application code here
Console.WriteLine("Application is running.");
}
else
{
Console.WriteLine("Another instance is already running.");
}
}
}
WPF Application Integration
using System.Windows;
using ktsu.SingleAppInstance;
namespace MyWpfApp
{
public partial class App : Application
{
protected override void OnStartup(StartupEventArgs e)
{
base.OnStartup(e);
if (!SingleAppInstance.ShouldLaunch())
{
MessageBox.Show("Application is already running.");
Shutdown();
return;
}
MainWindow = new MainWindow();
MainWindow.Show();
}
}
}
API Reference
SingleAppInstance
A static class that provides single-instance enforcement for applications. Uses a PID file stored in the application data directory to track running instances.
Methods
| Name | Return Type | Description |
|---|---|---|
ExitIfAlreadyRunning() |
void |
Checks if another instance is running and calls Environment.Exit(0) if so |
ShouldLaunch() |
bool |
Writes a PID file, waits 1 second for race condition detection, and returns true if safe to proceed |
Contributing
Contributions are welcome! Feel free to open issues or submit pull requests.
License
This project is licensed under the MIT License. See the LICENSE.md file for details.
No packages depend on ktsu.SingleAppInstance.
## v1.3.1 (patch)
Changes since v1.3.0:
- Bump Polyfill from 9.9.0 to 9.10.0 ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.3.0 (minor)
Changes since v1.2.0:
- Refactor IsAlreadyRunning method for improved clarity and efficiency; add legacy PID handling and enhance process checks ([@matt-edmondson](https://github.com/matt-edmondson))
- Add project configuration and documentation updates ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove outdated Copilot documentation and add CLAUDE.md for project guidance ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove legacy build scripts ([@matt-edmondson](https://github.com/matt-edmondson))
- migrate to dotnet 10 ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove unnecessary PackageReference for Polyfill from SingleAppInstance project ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove unnecessary PackageReference for Microsoft.Testing.Extensions.CodeCoverage ([@matt-edmondson](https://github.com/matt-edmondson))
- [patch] Fix TargetFrameworks property in test project ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove redundant package references from test project ([@matt-edmondson](https://github.com/matt-edmondson))
- Update .editorconfig, .gitignore, .runsettings, and PSBuild.psm1 for improved configurations and coverage settings ([@matt-edmondson](https://github.com/matt-edmondson))
- Update ktsu.AppDataStorage package version to 1.15.5 ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove Directory.Build.props, Directory.Build.targets, and several PowerShell scripts for metadata and version management. Update SingleAppInstance and its tests to use 'var' for variable declarations and add copyright information. ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove .markdownlint.json configuration file, update DESCRIPTION.md for clarity, and change project SDK references in .csproj files to ktsu.Sdk.Lib and ktsu.Sdk.Test version 1.8.0. ([@matt-edmondson](https://github.com/matt-edmondson))
- Update README to match standard template format ([@matt-edmondson](https://github.com/matt-edmondson))
- Update test command to run in a single process ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor SingleAppInstanceTests for better isolation ([@matt-edmondson](https://github.com/matt-edmondson))
- Clarify command line usage by providing an example for non-interactive mode with `git` commands ([@matt-edmondson](https://github.com/matt-edmondson))
- Add guidelines for using command line in non-interactive mode and directory context ([@matt-edmondson](https://github.com/matt-edmondson))
- Refine workflow guidelines for clarity on specialized tool usage and documentation checks ([@matt-edmondson](https://github.com/matt-edmondson))
- Update language-specific guidelines to clarify tool usage and fallback options ([@matt-edmondson](https://github.com/matt-edmondson))
- Update language-specific guidelines to clarify test execution commands and improve resource management ([@matt-edmondson](https://github.com/matt-edmondson))
- Set max cpus for tests to 1 ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor SingleAppInstanceTests to simplify file deletion logic and remove unnecessary try-finally blocks, ensuring clearer test flow and improved readability. ([@matt-edmondson](https://github.com/matt-edmondson))
- Comment out MaxCpuCount setting in .runsettings to disable process-level parallelization ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance SingleAppInstanceTests by adding assertions to verify PID file handling and initial state checks ([@matt-edmondson](https://github.com/matt-edmondson))
- Organize and enhance Copilot documentation with detailed guidelines on memory usage, coding standards, and project management practices. ([@matt-edmondson](https://github.com/matt-edmondson))
- Add SingleAppInstance.Test project to solution and configure build settings ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor SingleAppInstanceTests to improve clarity and structure of test methods, ensuring accurate PID file handling and process information validation. ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance memory.jsonl to include additional details for SingleAppInstance tests and project structure ([@matt-edmondson](https://github.com/matt-edmondson))
- Update Copilot instructions for .NET project build and testing guidelines ([@matt-edmondson](https://github.com/matt-edmondson))
- Refine README.md to enhance feature descriptions and clarify technical implementation details for SingleAppInstance ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance memory.jsonl to include advanced process detection and compatibility details for SingleAppInstance class ([@matt-edmondson](https://github.com/matt-edmondson))
- Refine README.md for clarity and usage instructions of SingleAppInstance ([@matt-edmondson](https://github.com/matt-edmondson))
- Add tests for SingleAppInstance behavior with no other instance running and custom launch logic ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance SingleAppInstance to store and verify process information in JSON format ([@matt-edmondson](https://github.com/matt-edmondson))
- Add memory.jsonl file with project and class details ([@matt-edmondson](https://github.com/matt-edmondson))
- Add workflow and process guidelines to Copilot instructions ([@matt-edmondson](https://github.com/matt-edmondson))
- Add comprehensive Copilot instructions and memory management guidelines ([@matt-edmondson](https://github.com/matt-edmondson))
- Add markdownlint configuration file for linting rules ([@matt-edmondson](https://github.com/matt-edmondson))
- Update packages ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.2.17 (patch)
Changes since v1.2.16:
- Bump the microsoft group with 2 updates ([@dependabot[bot]](https://github.com/dependabot[bot]))
- Bump the ktsu group with 1 update ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.2.16 (patch)
Changes since v1.2.15:
- Bump Polyfill from 9.8.1 to 9.9.0 ([@dependabot[bot]](https://github.com/dependabot[bot]))
- Bump the ktsu group with 3 updates ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.2.15 (patch)
Changes since v1.2.14:
- Remove outdated Copilot documentation and add CLAUDE.md for project guidance ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.2.15-pre.1 (prerelease)
No significant changes detected since v1.2.15.
## v1.2.14 (patch)
Changes since v1.2.13:
- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .github\workflows\dotnet.yml ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .github\workflows\dotnet.yml ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .github\workflows\dotnet.yml ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .github\workflows\dotnet.yml ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.2.14-pre.1 (prerelease)
No significant changes detected since v1.2.14.
## v1.2.13 (patch)
Changes since v1.2.12:
- Remove legacy build scripts ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.2.12 (patch)
Changes since v1.2.11:
- Sync .github\workflows\dotnet.yml ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync global.json ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Bump the ktsu group with 1 update ([@dependabot[bot]](https://github.com/dependabot[bot]))
- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\update-winget-manifests.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\update-winget-manifests.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\PSBuild.psm1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Bump the microsoft group with 2 updates ([@dependabot[bot]](https://github.com/dependabot[bot]))
- Bump MSTest.Sdk from 4.0.2 to 4.1.0 ([@dependabot[bot]](https://github.com/dependabot[bot]))
- Bump Polyfill from 9.8.0 to 9.8.1 ([@dependabot[bot]](https://github.com/dependabot[bot]))
- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\PSBuild.psm1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\PSBuild.psm1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync global.json ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Bump Polyfill from 9.7.7 to 9.8.0 ([@dependabot[bot]](https://github.com/dependabot[bot]))
- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync global.json ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync global.json ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync COPYRIGHT.md ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\PSBuild.psm1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\update-winget-manifests.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync global.json ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync COPYRIGHT.md ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Bump the ktsu group with 5 updates ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.2.12-pre.12 (prerelease)
Changes since v1.2.12-pre.11:
- Bump the ktsu group with 1 update ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.2.12-pre.11 (prerelease)
Changes since v1.2.12-pre.10:
- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\update-winget-manifests.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.2.12-pre.10 (prerelease)
Changes since v1.2.12-pre.9:
- Sync scripts\update-winget-manifests.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\PSBuild.psm1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Bump the microsoft group with 2 updates ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.2.12-pre.9 (prerelease)
Changes since v1.2.12-pre.8:
- Bump MSTest.Sdk from 4.0.2 to 4.1.0 ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.2.12-pre.8 (prerelease)
Changes since v1.2.12-pre.7:
- Bump Polyfill from 9.8.0 to 9.8.1 ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.2.12-pre.7 (prerelease)
Changes since v1.2.12-pre.6:
- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\PSBuild.psm1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\PSBuild.psm1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync global.json ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.2.12-pre.6 (prerelease)
Changes since v1.2.12-pre.5:
- Bump Polyfill from 9.7.7 to 9.8.0 ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.2.12-pre.5 (prerelease)
Changes since v1.2.12-pre.4:
- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync global.json ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.2.12-pre.4 (prerelease)
Changes since v1.2.12-pre.3:
- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync global.json ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync COPYRIGHT.md ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.2.12-pre.3 (prerelease)
Changes since v1.2.12-pre.2:
- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\PSBuild.psm1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.2.12-pre.2 (prerelease)
Changes since v1.2.12-pre.1:
- Sync scripts\update-winget-manifests.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync global.json ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync COPYRIGHT.md ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.2.12-pre.1 (prerelease)
No significant changes detected since v1.2.12.
## v1.2.11 (patch)
Changes since v1.2.10:
- Remove .github\workflows\project.yml ([@matt-edmondson](https://github.com/matt-edmondson))
- Bump Polyfill from 9.7.6 to 9.7.7 ([@dependabot[bot]](https://github.com/dependabot[bot]))
- Bump the ktsu group with 5 updates ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.2.11-pre.2 (prerelease)
Changes since v1.2.11-pre.1:
- Bump Polyfill from 9.7.6 to 9.7.7 ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.2.11-pre.1 (prerelease)
No significant changes detected since v1.2.11.
## v1.2.10 (patch)
Changes since v1.2.9:
- migrate to dotnet 10 ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.2.9 (patch)
Changes since v1.2.8:
- Remove unnecessary PackageReference for Polyfill from SingleAppInstance project ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.2.8 (patch)
Changes since v1.2.7:
- Remove unnecessary PackageReference for Microsoft.Testing.Extensions.CodeCoverage ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.2.8-pre.1 (prerelease)
No significant changes detected since v1.2.8.
## v1.2.7 (patch)
Changes since v1.2.6:
- [patch] Fix TargetFrameworks property in test project ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove redundant package references from test project ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.2.7-pre.4 (prerelease)
Changes since v1.2.7-pre.3:
- Sync scripts\update-winget-manifests.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.2.7-pre.3 (prerelease)
Changes since v1.2.7-pre.2:
- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .github\workflows\dotnet.yml ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.2.7-pre.2 (prerelease)
Changes since v1.2.7-pre.1:
- Sync scripts\PSBuild.psm1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .github\workflows\dotnet.yml ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.2.7-pre.1 (prerelease)
No significant changes detected since v1.2.7.
## v1.2.6 (patch)
Changes since v1.2.5:
- Update .editorconfig, .gitignore, .runsettings, and PSBuild.psm1 for improved configurations and coverage settings ([@matt-edmondson](https://github.com/matt-edmondson))
- Update ktsu.AppDataStorage package version to 1.15.5 ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.2.6-pre.18 (prerelease)
Changes since v1.2.6-pre.17:
- Merge remote-tracking branch 'refs/remotes/origin/main' ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\PSBuild.psm1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .editorconfig ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .gitattributes ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .gitignore ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .mailmap ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .runsettings ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.2.6-pre.17 (prerelease)
Changes since v1.2.6-pre.16:
- Update ktsu.AppDataStorage to 1.15.4 ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.2.6-pre.16 (prerelease)
Changes since v1.2.6-pre.15:
- Sync scripts\PSBuild.psm1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .editorconfig ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .gitattributes ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .gitignore ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .mailmap ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .runsettings ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.2.6-pre.15 (prerelease)
Changes since v1.2.6-pre.14:
## v1.2.6-pre.14 (prerelease)
Changes since v1.2.6-pre.13:
## v1.2.6-pre.13 (prerelease)
Changes since v1.2.6-pre.12:
## v1.2.6-pre.12 (prerelease)
Changes since v1.2.6-pre.11:
## v1.2.6-pre.11 (prerelease)
Changes since v1.2.6-pre.10:
## v1.2.6-pre.10 (prerelease)
Changes since v1.2.6-pre.9:
## v1.2.6-pre.9 (prerelease)
Changes since v1.2.6-pre.8:
## v1.2.6-pre.8 (prerelease)
Changes since v1.2.6-pre.7:
## v1.2.6-pre.7 (prerelease)
Changes since v1.2.6-pre.6:
## v1.2.6-pre.6 (prerelease)
Changes since v1.2.6-pre.5:
## v1.2.6-pre.5 (prerelease)
Changes since v1.2.6-pre.4:
## v1.2.6-pre.4 (prerelease)
Changes since v1.2.6-pre.3:
## v1.2.6-pre.3 (prerelease)
Changes since v1.2.6-pre.2:
## v1.2.6-pre.2 (prerelease)
Changes since v1.2.6-pre.1:
## v1.2.6-pre.1 (prerelease)
No significant changes detected since v1.2.6.
## v1.2.5 (patch)
Changes since v1.2.4:
- Remove Directory.Build.props, Directory.Build.targets, and several PowerShell scripts for metadata and version management. Update SingleAppInstance and its tests to use 'var' for variable declarations and add copyright information. ([@matt-edmondson](https://github.com/matt-edmondson))
- Remove .markdownlint.json configuration file, update DESCRIPTION.md for clarity, and change project SDK references in .csproj files to ktsu.Sdk.Lib and ktsu.Sdk.Test version 1.8.0. ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.2.5-pre.3 (prerelease)
Changes since v1.2.5-pre.2:
- Bump ktsu.AppDataStorage from 1.11.0 to 1.15.0 in the ktsu group ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.2.5-pre.2 (prerelease)
Changes since v1.2.5-pre.1:
- Bump ktsu.AppDataStorage from 1.7.2 to 1.11.0 in the ktsu group ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.2.5-pre.1 (prerelease)
No significant changes detected since v1.2.5.
## v1.2.4 (patch)
Changes since v1.2.3:
- Update README to match standard template format ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.2.3 (patch)
Changes since v1.2.2:
- Update test command to run in a single process ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor SingleAppInstanceTests for better isolation ([@matt-edmondson](https://github.com/matt-edmondson))
- Clarify command line usage by providing an example for non-interactive mode with `git` commands ([@matt-edmondson](https://github.com/matt-edmondson))
- Add guidelines for using command line in non-interactive mode and directory context ([@matt-edmondson](https://github.com/matt-edmondson))
- Refine workflow guidelines for clarity on specialized tool usage and documentation checks ([@matt-edmondson](https://github.com/matt-edmondson))
- Update language-specific guidelines to clarify tool usage and fallback options ([@matt-edmondson](https://github.com/matt-edmondson))
- Update language-specific guidelines to clarify test execution commands and improve resource management ([@matt-edmondson](https://github.com/matt-edmondson))
- Set max cpus for tests to 1 ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor SingleAppInstanceTests to simplify file deletion logic and remove unnecessary try-finally blocks, ensuring clearer test flow and improved readability. ([@matt-edmondson](https://github.com/matt-edmondson))
- Comment out MaxCpuCount setting in .runsettings to disable process-level parallelization ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance SingleAppInstanceTests by adding assertions to verify PID file handling and initial state checks ([@matt-edmondson](https://github.com/matt-edmondson))
- Organize and enhance Copilot documentation with detailed guidelines on memory usage, coding standards, and project management practices. ([@matt-edmondson](https://github.com/matt-edmondson))
- Add SingleAppInstance.Test project to solution and configure build settings ([@matt-edmondson](https://github.com/matt-edmondson))
- Refactor SingleAppInstanceTests to improve clarity and structure of test methods, ensuring accurate PID file handling and process information validation. ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance memory.jsonl to include additional details for SingleAppInstance tests and project structure ([@matt-edmondson](https://github.com/matt-edmondson))
- Update Copilot instructions for .NET project build and testing guidelines ([@matt-edmondson](https://github.com/matt-edmondson))
- Refine README.md to enhance feature descriptions and clarify technical implementation details for SingleAppInstance ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance memory.jsonl to include advanced process detection and compatibility details for SingleAppInstance class ([@matt-edmondson](https://github.com/matt-edmondson))
- Refine README.md for clarity and usage instructions of SingleAppInstance ([@matt-edmondson](https://github.com/matt-edmondson))
- Add tests for SingleAppInstance behavior with no other instance running and custom launch logic ([@matt-edmondson](https://github.com/matt-edmondson))
- Enhance SingleAppInstance to store and verify process information in JSON format ([@matt-edmondson](https://github.com/matt-edmondson))
- Add memory.jsonl file with project and class details ([@matt-edmondson](https://github.com/matt-edmondson))
- Add workflow and process guidelines to Copilot instructions ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.2.2 (patch)
Changes since v1.2.1:
- Add comprehensive Copilot instructions and memory management guidelines ([@matt-edmondson](https://github.com/matt-edmondson))
- Add markdownlint configuration file for linting rules ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.2.2-pre.3 (prerelease)
Changes since v1.2.2-pre.2:
- Bump ktsu.AppDataStorage from 1.7.1 to 1.7.2 in the ktsu group ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.2.2-pre.2 (prerelease)
Changes since v1.2.2-pre.1:
- Sync .editorconfig ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.2.2-pre.1 (prerelease)
No significant changes detected since v1.2.2.
## v1.2.1 (patch)
Changes since v1.2.0:
- Update packages ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.2.0 (minor)
Changes since v1.1.0:
- Add LICENSE template ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.1.1-pre.2 (prerelease)
Changes since v1.1.1-pre.1:
- Sync scripts\make-version.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\make-changelog.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.1.1-pre.1 (prerelease)
Changes since v1.1.0:
- Sync scripts\make-version.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\make-changelog.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .editorconfig ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync .gitignore ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync Directory.Build.targets ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.1.0 (minor)
Changes since v1.0.0-pre.19:
- Apply new editorconfig ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.0-pre.19 (prerelease)
Changes since v1.0.0-pre.18:
- Bump ktsu.AppDataStorage from 1.4.7 to 1.5.0 in the ktsu group ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.0.0-pre.18 (prerelease)
Changes since v1.0.0-pre.17:
- Sync scripts\make-version.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\make-changelog.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.0.0-pre.17 (prerelease)
Changes since v1.0.0-pre.16:
- Sync .github\workflows\dotnet.yml ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.0.0-pre.16 (prerelease)
Changes since v1.0.0-pre.15:
- Sync scripts\make-version.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
- Sync scripts\make-changelog.ps1 ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.0.0-pre.15 (prerelease)
Changes since v1.0.0-pre.14:
- Sync .github\workflows\dotnet.yml ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.0.0-pre.14 (prerelease)
Changes since v1.0.0-pre.13:
- Revert unintended changes ([@Damon3000s](https://github.com/Damon3000s))
- Review Feedback ([@Damon3000s](https://github.com/Damon3000s))
- Create the directory the Pid will be stored in ([@Damon3000s](https://github.com/Damon3000s))
## v1.0.0-pre.13 (prerelease)
Changes since v1.0.0-pre.12:
- Sync .github\workflows\dotnet.yml ([@ktsu[bot]](https://github.com/ktsu[bot]))
## v1.0.0-pre.12 (prerelease)
Changes since v1.0.0-pre.11:
## v1.0.0-pre.11 (prerelease)
Changes since v1.0.0-pre.10:
## v1.0.0-pre.10 (prerelease)
Changes since v1.0.0-pre.9:
- Catch DirectoryNotFoundException ([@Damon3000s](https://github.com/Damon3000s))
## v1.0.0-pre.9 (prerelease)
Changes since v1.0.0-pre.8:
- Bump MSTest from 3.7.2 to 3.7.3 ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.0.0-pre.8 (prerelease)
Changes since v1.0.0-pre.7:
## v1.0.0-pre.7 (prerelease)
Changes since v1.0.0-pre.6:
## v1.0.0-pre.6 (prerelease)
Changes since v1.0.0-pre.5:
- Bump MSTest from 3.7.1 to 3.7.2 ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.0.0-pre.5 (prerelease)
Changes since v1.0.0-pre.4:
- Bump coverlet.collector from 6.0.3 to 6.0.4 ([@dependabot[bot]](https://github.com/dependabot[bot]))
## v1.0.0-pre.4 (prerelease)
Changes since v1.0.0-pre.3:
## v1.0.0-pre.3 (prerelease)
Changes since v1.0.0-pre.2:
## v1.0.0-pre.2 (prerelease)
Changes since v1.0.0-pre.1:
- Remove ktsu.ScopedAction package from project ([@matt-edmondson](https://github.com/matt-edmondson))
## v1.0.0-pre.1 (prerelease)
No significant changes detected since v0.0.1-pre.1.
## v0.0.1-pre.1 (prerelease)
- Remove ktsu.ScopedAction package from project ([@matt-edmondson](https://github.com/matt-edmondson))
- Initial commit ([@matt-edmondson](https://github.com/matt-edmondson))
.NET 5.0
- Polyfill (>= 9.10.0)
- ktsu.AppDataStorage (>= 1.16.0)
- ktsu.Semantics.Paths (>= 1.0.31)
.NET Standard 2.1
- ktsu.Semantics.Paths (>= 1.0.31)
- ktsu.AppDataStorage (>= 1.16.0)
- Polyfill (>= 9.10.0)
.NET Standard 2.0
- ktsu.Semantics.Paths (>= 1.0.31)
- ktsu.AppDataStorage (>= 1.16.0)
- Polyfill (>= 9.10.0)
.NET 10.0
- ktsu.Semantics.Paths (>= 1.0.31)
- Polyfill (>= 9.10.0)
- ktsu.AppDataStorage (>= 1.16.0)
.NET 9.0
- ktsu.Semantics.Paths (>= 1.0.31)
- ktsu.AppDataStorage (>= 1.16.0)
- Polyfill (>= 9.10.0)
.NET 8.0
- ktsu.AppDataStorage (>= 1.16.0)
- ktsu.Semantics.Paths (>= 1.0.31)
- Polyfill (>= 9.10.0)
.NET 6.0
- Polyfill (>= 9.10.0)
- ktsu.AppDataStorage (>= 1.16.0)
- ktsu.Semantics.Paths (>= 1.0.31)
.NET 7.0
- ktsu.AppDataStorage (>= 1.16.0)
- ktsu.Semantics.Paths (>= 1.0.31)
- Polyfill (>= 9.10.0)
| Version | Downloads | Last updated |
|---|---|---|
| 1.3.13 | 0 | 04/13/2026 |
| 1.3.12 | 1 | 04/10/2026 |
| 1.3.11 | 1 | 04/09/2026 |
| 1.3.10 | 1 | 04/08/2026 |
| 1.3.9 | 1 | 04/07/2026 |
| 1.3.8 | 1 | 04/06/2026 |
| 1.3.7 | 0 | 04/03/2026 |
| 1.3.6 | 1 | 04/02/2026 |
| 1.3.5 | 1 | 02/27/2026 |
| 1.3.4 | 16 | 02/26/2026 |
| 1.3.3 | 37 | 02/25/2026 |
| 1.3.2 | 38 | 02/24/2026 |
| 1.3.1 | 51 | 02/23/2026 |
| 1.3.0 | 54 | 02/20/2026 |
| 1.2.17 | 54 | 02/19/2026 |
| 1.2.16 | 55 | 02/18/2026 |
| 1.2.15 | 54 | 02/17/2026 |
| 1.2.15-pre.1 | 53 | 02/17/2026 |
| 1.2.14 | 53 | 02/16/2026 |
| 1.2.14-pre.1 | 54 | 02/16/2026 |
| 1.2.13 | 54 | 02/14/2026 |
| 1.2.12 | 53 | 02/14/2026 |
| 1.2.12-pre.12 | 57 | 02/06/2026 |
| 1.2.12-pre.11 | 57 | 02/06/2026 |
| 1.2.12-pre.10 | 60 | 02/05/2026 |
| 1.2.12-pre.9 | 57 | 02/04/2026 |
| 1.2.12-pre.8 | 57 | 02/03/2026 |
| 1.2.12-pre.7 | 59 | 02/03/2026 |
| 1.2.12-pre.6 | 59 | 02/02/2026 |
| 1.2.12-pre.5 | 59 | 02/01/2026 |
| 1.2.12-pre.4 | 60 | 01/31/2026 |
| 1.2.12-pre.3 | 60 | 01/31/2026 |
| 1.2.12-pre.2 | 61 | 01/31/2026 |
| 1.2.12-pre.1 | 59 | 01/30/2026 |
| 1.2.11 | 61 | 01/30/2026 |
| 1.2.11-pre.2 | 61 | 01/29/2026 |
| 1.2.11-pre.1 | 59 | 01/28/2026 |
| 1.2.10 | 62 | 01/28/2026 |
| 1.2.9 | 75 | 01/13/2026 |
| 1.2.8 | 75 | 01/12/2026 |
| 1.2.8-pre.1 | 88 | 01/08/2026 |
| 1.2.7 | 88 | 01/08/2026 |
| 1.2.7-pre.4 | 145 | 11/24/2025 |
| 1.2.7-pre.3 | 138 | 11/23/2025 |
| 1.2.7-pre.2 | 137 | 11/23/2025 |
| 1.2.7-pre.1 | 137 | 11/23/2025 |
| 1.2.6 | 140 | 08/25/2025 |