afk

dhofheinz/afk

Productivity

About

SKILL.md

AFK Mode Skill

Manage AFK (Away From Keyboard) mode with tiered tool access and session tracking.

Operations

Enable AFK mode - Activate AFK with tiered tool access (full/plan/research/monitor)
Disable AFK mode - Turn off AFK and resume normal operation
Check status - View current AFK status and statistics
Review session - Review planning documents and blocked actions

Routing

Parse $ARGUMENTS to determine the operation:

First Word	Operation	Description
`full`	enable.md	No tools allowed
`plan`	enable.md	Read-only tools (Read, Glob, Grep)
`research`	enable.md	Read + web (WebFetch, WebSearch)
`monitor`	enable.md	Read + Bash
`off`	off.md	Disable AFK mode
`status`	status.md	Show current status
`review`	review.md	Review planning session
(empty/other)	enable.md	Default to full mode

Usage Examples

/afk                           → full mode, default message
/afk full "In a meeting"       → full mode, custom message
/afk plan "Explore codebase"   → plan mode (read-only)
/afk research                  → research mode (read + web)
/afk off                       → disable
/afk status                    → check status
/afk review                    → review current/last session
/afk review 20240115_103000    → review specific session

State Management

All state operations use the script at scripts/state.sh:

"${CLAUDE_PLUGIN_ROOT}/skills/afk/scripts/state.sh" <command> [args]

Commands: enable, disable, is-enabled, get-state, get-mode, get-message, get-allowed, is-allowed, get-plan-path, get-log-path