Command line (ppp)

Tag, rate and comment on files from scripts, automations and AI agents.

Everything you can do to a file with Tag+, Rate+ and Comment+ from the right-click menu, you can also do from PowerShell, a batch file, a scheduled task - or an AI agent. ppp is installed with Productivity Plus Pack and added to your PATH, so it is ready in any new terminal.

It was built to be driven by other programs. Ask for --json and you get one result per file; try a change first with --dry-run; and since there is no "toggle", running a command twice never undoes it. An agent can read ppp help --json to learn every command on its own.

# Tag every PDF in a folder
ppp tag add --tag Invoices C:\Docs\*.pdf

# Rate a photo four stars
ppp rate set --stars 4 photo.jpg

# Read everything about a file as JSON
ppp info --json report.docx

Why you'll love the command line

Examples

Tag the results of a script

Pipe paths in from PowerShell, one per line, and end the command with -.

Get-ChildItem C:\Projects -Recurse -Filter *.docx |
    Where-Object LastWriteTime -lt (Get-Date).AddYears(-1) |
    ForEach-Object FullName |
    ppp tag add --tag Archive -

Replace all tags, after a dry run

set leaves exactly the tags you give. Check first, then run it for real.

ppp tag set --tag Signed --tag Contract --dry-run C:\Contracts\*.pdf
ppp tag set --tag Signed --tag Contract C:\Contracts\*.pdf

Leave a note an AI wrote

Have an agent summarize a document, then save the summary as the file's Comment+ comment, where you can search for it in File Explorer.

ppp comment set --text-file summary.txt notes.pdf
ppp comment get --json notes.pdf

Let an agent discover the commands

One call describes every command, option, exit code and result status as JSON.

ppp help --json

Frequently Asked Questions

How do I start using ppp?

Install Productivity Plus Pack from the direct download. The installer adds ppp to your PATH, so open a new PowerShell or Command Prompt window and run ppp help.

Can an AI agent use ppp?

Yes. Any agent that can run a command can use it. ppp help --json describes every command, option and exit code, --json returns one result per file, and add, remove and set can be retried safely because none of them toggles.

Is it the same as tagging from the right-click menu?

Yes. ppp uses the same engine as Tag+, Rate+ and Comment+, so tags, ratings and comments show up in File Explorer and its search filters exactly as if you had set them from the menu.

How do I know a change worked?

Every write is read back. A file is reported as changed only if the new value is there when read again, as unchanged if it was already in that state, or as an error with a code such as not_found or unsupported_type. The exit code is 0 when every file ended in the requested state.

Is ppp in the Microsoft Store edition?

Not yet. ppp is installed with the direct download.

Get the command line with Productivity Plus Pack

Free 30-day trial, no account or credit card needed. Then one payment for every feature and every future update — no subscription.