Developer & User Reference

TamerScript Documentation

Everything you need to master AST-based rules, visual builder conditions, and Claude Desktop MCP automation.

1. Quick Start 2. Supported Fields 3. Operators & Units 4. Desktop Actions 5. Claude Desktop MCP

1. Quick Start

FolderTamer evaluates rules using an Abstract Syntax Tree (AST) parser. You can build rules visually using dropdowns or type TamerScript directly into the Advanced tab.

# Move large PDFs older than 7 days

file.extension == ".pdf" and file.size > 50MB and file.age > 7d

2. Supported Fields

Field	Type	Description	Example
file.name	String	Full file name with extension	file.name contains "invoice"
file.basename	String	File name without extension	file.basename == "report_2026"
file.extension	String	File extension with leading dot	file.extension in [".png", ".jpg"]
file.size	Size	File size on disk	file.size > 500MB
file.age	Time	Time elapsed since modification	file.age > 14d
file.content	Text	Text inside .txt, .json, .csv, .pdf	file.content contains "TAX"
file.parent	String	Immediate parent directory name	file.parent == "Downloads"

3. Operators & Dynamic Units

TamerScript supports rich operators and human-friendly measurement units:

Size Units

Supported: Bytes, KB, MB, GB, TB.

file.size >= 10MB and file.size <= 100MB

Time & Age Units

Supported: m (minutes), h (hours), d (days), w (weeks), mo (months).

file.age > 3d # older than 3 days

List Matching (in)

Check if a string or extension exists in a list:

file.extension in [".pdf", ".docx", ".xlsx"]

Match Logic (AND / OR / NOT)

Combine multiple conditions with compound operators:

not (file.extension == ".tmp" or file.name contains "cache")

4. 10 Desktop Actions & Pipeline Tokens

Attach one or multiple chained actions to any rule:

1. Move to Folder: Relocates file with token support.

2. Copy to Folder: Creates duplicates at target path.

3. Rename File: Pattern tokens: {OriginalName}_{YYYY-MM-DD}.

4. Send to Recycle Bin: Safe deletion with Undo support.

5. Permanently Delete: Immediate hard shred.

6. Compress to ZIP: Creates .zip archive containing file.

7. Extract Archive: Unpacks .zip drops into target folder.

8. Open with App: Launches system default or custom executable.

9. Run Script: Passes file path ($1) to PowerShell script.

10. Notification: Displays native Windows toast notification.

5. Claude Desktop MCP Server Setup

FolderTamer features an embedded, loopback Model Context Protocol (MCP) server. When FolderTamer is running, Claude Desktop can organize your PC using natural language.

Add this to your claude_desktop_config.json:

{ "mcpServers": { "foldertamer": { "url": "http://127.0.0.1:49152/sse" } } }