RU: Settings
View or modify the loop settings.
Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.
Arguments
show(default): Display current configurationreset: Reset to defaults (removes project config)set <key>=<value>: Set a specific config value
Execution
/usr/bin/env bash << 'RU_CONFIG_SCRIPT'
PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(pwd)}"
CONFIG_FILE="$PROJECT_DIR/.claude/ru-config.json"
STATE_FILE="$PROJECT_DIR/.claude/ru-state.json"
ARGS="${ARGUMENTS:-show}"
case "$ARGS" in
"show"|"")
echo "=== RU Configuration ==="
echo ""
echo "--- State ---"
if [[ -f "$STATE_FILE" ]]; then
echo "State: $(jq -r '.state // "stopped"' "$STATE_FILE")"
else
echo "State: stopped (no state file)"
fi
echo ""
echo "--- Config ---"
if [[ -f "$CONFIG_FILE" ]]; then
cat "$CONFIG_FILE" | python3 -m json.tool
else
echo "(using defaults - no project config)"
fi
;;
"reset")
rm -f "$CONFIG_FILE" "$STATE_FILE"
echo "Config reset to defaults."
;;
set\ *)
KEY_VALUE="${ARGS#set }"
KEY=$(echo "$KEY_VALUE" | cut -d= -f1)
VALUE=$(echo "$KEY_VALUE" | cut -d= -f2-)
if [[ -z "$KEY" || -z "$VALUE" ]]; then
echo "Usage: /ru:settings set <key>=<value>"
exit 1
fi
if [[ ! -f "$CONFIG_FILE" ]]; then
echo '{}' > "$CONFIG_FILE"
fi
JQ_PATH=".$KEY"
if [[ "$VALUE" =~ ^[0-9]+(\.[0-9]+)?$ ]]; then
jq "$JQ_PATH = $VALUE" "$CONFIG_FILE" > "$CONFIG_FILE.tmp" && mv "$CONFIG_FILE.tmp" "$CONFIG_FILE"
elif [[ "$VALUE" == "true" || "$VALUE" == "false" ]]; then
jq "$JQ_PATH = $VALUE" "$CONFIG_FILE" > "$CONFIG_FILE.tmp" && mv "$CONFIG_FILE.tmp" "$CONFIG_FILE"
else
jq "$JQ_PATH = \"$VALUE\"" "$CONFIG_FILE" > "$CONFIG_FILE.tmp" && mv "$CONFIG_FILE.tmp" "$CONFIG_FILE"
fi
echo "Set $KEY = $VALUE"
;;
*)
echo "Usage: /ru:settings [show|reset|set <key>=<value>]"
;;
esac
RU_CONFIG_SCRIPTRun the bash script above to manage configuration.
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| Config file not found | .claude dir missing | Create with mkdir -p.claude |
| jq error on set | Invalid value syntax | Check value type (number, string, bool) |
| python3 not found | python3 not in PATH | Install Python 3 or use jq. instead |
| Reset removes state | Intentional behavior | State file is also removed on reset |
| Changes not applying | Using wrong config file | Check PROJECT_DIR matches your cwd |
Post-Execution Reflection
After this skill completes, check before closing:
- Did the command succeed? — If not, fix the instruction or error table that caused the failure.
- Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
- Was a workaround needed? — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.
Only update if the issue is real and reproducible — not speculative.