get-focus-mode
Get the current macOS Focus mode
Why use this skill?
Learn how to use the get-focus-mode OpenClaw skill to monitor your active macOS Focus state, optimize your workflow, and manage AI notifications effectively.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/nickchristensen/get-focus-modeWhat This Skill Does
The get-focus-mode skill is a specialized utility designed for macOS users to programmatically detect the currently active Focus mode. By tapping into the system's focus status, this skill provides real-time feedback on whether the user is in a state of deep work, resting, or available for communication. The output returns clear, human-readable strings such as "No Focus", "Office", "Sleep", or "Do Not Disturb", allowing the OpenClaw AI agent to make informed decisions about whether to interrupt the user or suppress notifications based on their current activity state.
Installation
To integrate this functionality into your environment, ensure you have the jq command-line JSON processor installed, as it is a mandatory dependency for parsing system status outputs. Install the skill by running the following command in your terminal:
clawhub install openclaw/skills/skills/nickchristensen/get-focus-mode
Once installed, the skill resides in your local skill directory and can be executed directly by the OpenClaw agent to query your system state.
Use Cases
This skill is highly valuable for personal productivity workflows. For instance, you can create automation that silences non-urgent system alerts when the "Office" focus mode is detected. It is also ideal for dashboard builders who want to sync their desktop status with other applications, such as setting a Slack status to "Deep Work" automatically when the agent detects a specific Focus mode. It bridges the gap between your physical system state and your AI-driven digital environment.
Example Prompts
- "Check my current Focus mode and tell me if I should be available for incoming calls."
- "If my Focus mode is set to Sleep, please mute all terminal notifications until I wake up."
- "What is my active Focus mode right now?"
Tips & Limitations
This skill is exclusive to macOS environments and relies on the native system configuration. Ensure your macOS permissions allow the OpenClaw agent to execute system-level scripts. Note that the accuracy of the returned state is dependent on the macOS system providing the data through standard interfaces. If you have custom focus modes, verify that the skill logic covers your specific naming conventions, as it is pre-configured for standard macOS statuses like 'Do Not Disturb' and 'Sleep'.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-nickchristensen-get-focus-mode": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: code-execution