Windows Registry
Apps & Automationwindows-registryWindows Registry is an Agent Skill for apps & automation published in the taracodlabs/aiden repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Read, write, query Windows Registry via PowerShell provider
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/taracodlabs/aiden/blob/HEAD/skills/windows-registry/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/windows-registry, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Windows Registry
Read and write Windows Registry keys and values using PowerShell's built-in Registry provider — inspect startup entries, app settings, and system configuration without regedit.
When to Use
- User wants to read a registry value (e.g., installed software, startup entries)
- User asks to create or modify a registry key or value
- User wants to list all values under a registry path
- User needs to check what programs run at Windows startup
- User asks to remove a registry value or key
How to Use
Read a single registry value
Get-ItemPropertyValue -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Explorer" `
-Name "ShellState"
List all values under a key
Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion"
Check startup programs (current user and all users)
# Current user only
Get-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Run"
# All users (machine-wide)
Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Run"
Create a new registry key
New-Item -Path "HKCU:\Software\Aiden" -Force
Set a registry value (string)
Set-ItemProperty -Path "HKCU:\Software\Aiden" -Name "Version" -Value "3.5.0" -Type String
Set a registry value (DWORD)
Set-ItemProperty -Path "HKCU:\Software\Aiden" -Name "Enabled" -Value 1 -Type DWord
Delete a registry value
Remove-ItemProperty -Path "HKCU:\Software\Aiden" -Name "OldSetting"
Delete a registry key and all subkeys
Remove-Item -Path "HKCU:\Software\Aiden" -Recurse -Force
Search registry for a value name
Get-ChildItem -Path "HKLM:\SOFTWARE" -Recurse -ErrorAction SilentlyContinue |
Where-Object { $_.Property -contains "DisplayName" } |
Get-ItemProperty |
Select-Object DisplayName, DisplayVersion, Publisher |
Sort-Object DisplayName
List installed software
Get-ItemProperty "HKLM:\Software\Microsoft\Windows\CurrentVersion\Uninstall\*" |
Select-Object DisplayName, DisplayVersion, Publisher, InstallDate |
Where-Object DisplayName |
Sort-Object DisplayName
Examples
"What programs launch at startup for my user?"
→ Get-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Run" — each value name is an entry, value data is the command.
"List all installed software with version numbers" → Query both HKLM and HKCU Uninstall keys and merge results.
"Add a registry entry to run a script at login"
→ Set-ItemProperty -Path "HKCU:\...\Run" -Name "MyScript" -Value "powershell.exe -File C:\scripts\login.ps1"
Cautions
- Modifying HKLM keys requires an elevated session (UAC dialog) — HKCU keys do not
- Always read a key before modifying it to understand the current state
- Deleting registry keys is permanent — there is no Recycle Bin for registry changes
- Back up a key before editing:
reg export "HKCU\Software\Aiden" C:\backup\aiden-backup.reg - Registry paths in PowerShell use
\as separator (not/) and hive aliases likeHKCU:andHKLM: