PrivacyCtl

Imported from yunusgungor/privarion (Sources/PrivacyCtl/AGENTS.md). Install upstream with npx skills add yunusgungor/privarion --skill PrivacyCtl. Copyright stays with the author.

PrivacyCtl

CLI tool using Swift ArgumentParser.

OVERVIEW

Terminal-based privacy management. 14 commands in single 3053-line main.swift.

ENTRY POINT

• Sources/PrivacyCtl/main.swift (3053 lines) - All commands inline
• PrivarionGUIApp.swift - @main for GUI (separate target)

COMMAND STRUCTURE

PrivacyCtl (root) - AsyncParsableCommand
├── start, stop, status           # System control
├── config (list/get/set/reset)   # Configuration
├── profile (list/switch/create/delete)  # Profile management
├── logs                          # Log viewing
├── inject                        # DYLD injection
├── hook                          # Syscall hooks
├── identity                      # Identity spoofing
├── mac-address                   # MAC operations
├── network                       # Network filtering
├── analytics                     # System analytics
└── permission                    # TCC permissions

FILES

WHERE TO LOOK

CONVENTIONS

• Swift ArgumentParser (AsyncParsableCommand)
• Async commands via async throws
• Commands in single file (non-standard)

ANTI-PATTERNS

• Monolithic: 3053-line main.swift violates single responsibility
• No modularity: All commands in one file
• Silent errors: Multiple try? without handling (44+ instances in codebase)
• Force unwraps: 26 instances, many in critical paths