Proxyman App Settings
Guide the current Proxyman macOS Settings window without treating every preference as an MCP or CLI operation.
Select The Relevant Reference
- Read General, Appearance, and Privacy for certificates, proxy port/startup behavior, layout, theme/editor display, analytics, or crash reporting.
- Read Workspace, Tools, and Integrations for Team Workspace, Map Local/Scripting defaults, copy/export preferences, GitHub Gist, Products, or MCP.
- Read Advanced for the Proxy Helper Tool, time format, window/resource behavior, update notifications, proxy restoration, or app language.
Read more than one reference only when the request spans those tabs.
Establish The Actual UI
This skill's bundled catalog is a reviewed macOS snapshot. Before giving exact current instructions:
- Identify the installed Proxyman version, distribution, and platform when available.
- Open the Settings window and use its visible tab/control names as the authority for that build.
- When product behavior or documentation may have changed, fetch
https://docs.proxyman.com/llms.txt, follow the selected .md link, and cite the corresponding public page. Do not invent a documentation URL.
- Account for build differences. The reviewed Setapp build omits Workspace and changes some Products destinations.
Do not claim the Windows or Linux Settings UI matches this macOS catalog unless the installed build confirms it.
Handle A Settings Request
- Restate the desired outcome and identify the owning tab and control.
- Read the current value before changing it. For audits, report current, recommended target, consequence, and any restart requirement separately.
- Check whether the control is unavailable because of license, build, organization/CLI policy, current certificate state, or a genuinely disabled/coming-soon implementation.
- Explain material side effects before the change. Obtain confirmation immediately before certificate/private-key export or deletion, trust-store changes, helper-tool install/removal, GitHub authorization/removal, public sharing, disabling AI redaction, or exposing script environment variables.
- Apply only the requested setting through the interface actually exposed by the installed build.
- Verify by reopening the tab or observing the independent effect described in the relevant reference. A click or saved checkbox alone is not sufficient when runtime behavior is testable.
- State how to restore the previous value. Record the prior value first when a change affects routing, trust, external sharing, or privacy.
Ordinary reversible display preferences do not need extra confirmation when the user already asked for the change.
Interface Boundary
The reviewed MCP server has no generic read/write API for App Settings. Use the GUI as the canonical interface unless a specialized overlap exists:
- MCP can inspect/install/uninstall the generated root certificate, but it does not expose every General certificate action.
- MCP can read system/proxy status and change current system-proxy or External Proxy state, but those are not substitutes for startup preferences or arbitrary proxy-port editing.
proxyman-cli mcp on|off controls the MCP organization/CLI lock and persisted server state; discover installed help before use.proxyman-cli export and import operate only on the configuration scope documented by the installed command. Do not assume they serialize every tab.- Most Appearance, Privacy, Workspace, Tools, GitHub, Products, and Advanced preferences are GUI-only in the reviewed interfaces.
Route generated/custom certificate lifecycle, Debug Mode, Reset Network Proxy, and Factory Reset to proxyman-certificates-recovery; live traffic/rule operations to proxyman-traffic-debugging; exact shell automation to proxyman-cli; MCP client connection work to proxyman-mcp-setup; and per-rule feature guidance to proxyman-debugging-tools.
Response Shape
For guidance or an audit, report:
Tab > control
Current state (if observed)
What it changes
How to change it
How to verify
Restart / license / build limitation
Risk and rollback (when material)
Official docs (when available)
Say when no dedicated public documentation exists; use the installed UI and reviewed source behavior instead of stretching an unrelated page into evidence.
1---2name: proxyman-app-settings3description: Inspect, explain, audit, and safely change Proxyman macOS App Settings. Use when a user asks where a preference lives, what it does, why it is locked or ineffective, or requests a settings change or review. Do not use for individual debugging-tool rules.4---5
6# Proxyman App Settings
7
8Guide the current Proxyman macOS Settings window without treating every preference as an MCP or CLI operation.
9
10## Select The Relevant Reference
11
12- Read [General, Appearance, and Privacy](references/general-appearance-privacy.md) for certificates, proxy port/startup behavior, layout, theme/editor display, analytics, or crash reporting.
13- Read [Workspace, Tools, and Integrations](references/workspace-tools-integrations.md) for Team Workspace, Map Local/Scripting defaults, copy/export preferences, GitHub Gist, Products, or MCP.
14- Read [Advanced](references/advanced.md) for the Proxy Helper Tool, time format, window/resource behavior, update notifications, proxy restoration, or app language.
15
16Read more than one reference only when the request spans those tabs.
17
18## Establish The Actual UI
19
20This skill's bundled catalog is a reviewed macOS snapshot. Before giving exact current instructions:
21
221. Identify the installed Proxyman version, distribution, and platform when available.
232. Open the Settings window and use its visible tab/control names as the authority for that build.
243. When product behavior or documentation may have changed, fetch `https://docs.proxyman.com/llms.txt`, follow the selected `.md` link, and cite the corresponding public page. Do not invent a documentation URL.
254. Account for build differences. The reviewed Setapp build omits Workspace and changes some Products destinations.
26
27Do not claim the Windows or Linux Settings UI matches this macOS catalog unless the installed build confirms it.
28
29## Handle A Settings Request
30
311. Restate the desired outcome and identify the owning tab and control.
322. Read the current value before changing it. For audits, report current, recommended target, consequence, and any restart requirement separately.
333. Check whether the control is unavailable because of license, build, organization/CLI policy, current certificate state, or a genuinely disabled/coming-soon implementation.
344. Explain material side effects before the change. Obtain confirmation immediately before certificate/private-key export or deletion, trust-store changes, helper-tool install/removal, GitHub authorization/removal, public sharing, disabling AI redaction, or exposing script environment variables.
355. Apply only the requested setting through the interface actually exposed by the installed build.
366. Verify by reopening the tab or observing the independent effect described in the relevant reference. A click or saved checkbox alone is not sufficient when runtime behavior is testable.
377. State how to restore the previous value. Record the prior value first when a change affects routing, trust, external sharing, or privacy.
38
39Ordinary reversible display preferences do not need extra confirmation when the user already asked for the change.
40
41## Interface Boundary
42
43The reviewed MCP server has no generic read/write API for App Settings. Use the GUI as the canonical interface unless a specialized overlap exists:
44
45- MCP can inspect/install/uninstall the generated root certificate, but it does not expose every General certificate action.
46- MCP can read system/proxy status and change current system-proxy or External Proxy state, but those are not substitutes for startup preferences or arbitrary proxy-port editing.
47- `proxyman-cli mcp on|off` controls the MCP organization/CLI lock and persisted server state; discover installed help before use.
48- `proxyman-cli export` and `import` operate only on the configuration scope documented by the installed command. Do not assume they serialize every tab.
49- Most Appearance, Privacy, Workspace, Tools, GitHub, Products, and Advanced preferences are GUI-only in the reviewed interfaces.
50
51Route generated/custom certificate lifecycle, Debug Mode, Reset Network Proxy, and Factory Reset to `proxyman-certificates-recovery`; live traffic/rule operations to `proxyman-traffic-debugging`; exact shell automation to `proxyman-cli`; MCP client connection work to `proxyman-mcp-setup`; and per-rule feature guidance to `proxyman-debugging-tools`.
52
53## Response Shape
54
55For guidance or an audit, report:
56
57```text
58Tab > control
59Current state (if observed)
60What it changes
61How to change it
62How to verify
63Restart / license / build limitation
64Risk and rollback (when material)
65Official docs (when available)
66```
67
68Say when no dedicated public documentation exists; use the installed UI and reviewed source behavior instead of stretching an unrelated page into evidence.
proxymanapp