One-click install
npx skills add https://github.com/selfagency/agentsy --skill cmux-settings-selfagency
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cmux-settings
Source: https://github.com/selfagency/agentsy/tree/main/.agents/skills/cmux-settings
Command: npx skills add https://github.com/selfagency/agentsy --skill cmux-settings-selfagency

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill prevents broken or unsupported cmux configuration by letting you edit cmux.json safely, validate recognized keys, and rely on live reload instead of trial-and-error.

Core Features & Use Cases

  • Configure cmux preferences via JSON paths: Map natural-language goals (like appearance, sidebar behavior, notifications, automation, browser rules, or shortcuts) to exact dotted keys in cmux.json.
  • Deterministic read/write with validation: Use the bundled helper to strip JSONC comments, write atomically, and validate keys against the official schema.
  • Workflow for verification and quick recovery: Get values back by path, validate after changes, and unset keys to revert to cmux defaults.

Quick Start

Set the sidebar tint to match the terminal background by asking: set sidebarAppearance.matchTerminalBackground to true in cmux.json, then validate the configuration.

Frequently Asked Questions about cmux-settings

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely edit cmux.json configuration settings without breaking the file?

You can validate cmux.json settings by using schema-based key validation after editing. This checks recognized keys and applies changes via live reload, ensuring your configuration remains supported and error-free.

How can I configure keyboard shortcuts and sidebar appearance in cmux?

You can revert cmux settings to defaults by using the unset operation on specific JSON paths. This removes your custom configurations and restores the original default values for those specific keys.

Does cmux configuration support JSONC comments during validation?

Yes, cmux configuration validation supports JSONC comments. The bundled helper automatically strips comments during read and write operations, allowing you to safely annotate your cmux.json file without causing parse errors.

What is the best way to manage embedded browser rules and automation in cmux?

The best way to manage embedded browser rules and automation is to use JSON-path operations to set specific keys in cmux.json. This method provides deterministic writes and immediate confirmation via auto-reload.

Why are my cmux configuration changes not applying automatically?

Your cmux configuration changes may not apply if the keys are not validated against the schema. Using a configuration manager ensures atomic writes and triggers live reload for immediate confirmation of your settings.