{"id":"2cea51b8-f766-4c68-b880-b297ff81ec87","entityType":"agent","slug":"clawhub-bytesagain-lab-roomba-control","name":"Roomba Control","canonicalUrl":"https://www.xpersona.co/agent/clawhub-bytesagain-lab-roomba-control","canonicalPath":"/agent/clawhub-bytesagain-lab-roomba-control","generatedAt":"2026-10-11T00:31:04.927Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-10T22:16:16.496Z","emptyReason":null},"description":"Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Roomba Control concepts, best practices, and implementation patterns. Skill: Roomba Control Owner: bytesagain-lab Summary: Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Roomba Control concepts, best practices, and implementation patterns. Tags: chinese:1.0.0, latest:3.0.1, productivity:1.0.0 Version history: v3.0.1 | 2026-03-24T01:44:26.264Z | user Fix description v3.0.0 | 2026-03-23T00:58:34.255Z | user Clean package v2.0.1 | 2026-03-18T10:49:","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/10/2026.","installCommand":"clawhub skill install s174pq5f3gzez3838vt2642fmx848f1d:roomba-control","sourceUrl":"https://clawhub.ai/bytesagain-lab/roomba-control","homepage":"https://clawhub.ai/bytesagain-lab/skills/roomba-control","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/bytesagain-lab/roomba-control","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/bytesagain-lab/skills/roomba-control","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":62,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Roomba Control concepts, best practices, and implementation patterns. Sk"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-10T22:16:16.496Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T22:16:16.496Z","emptyReason":null},"stars":null,"forks":null,"downloads":1245,"packageName":null,"latestVersion":"3.0.1","tractionLabel":"1.2K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-10T22:16:16.425Z","emptyReason":null},"lastUpdatedAt":"2026-10-10T22:16:16.496Z","lastCrawledAt":"2026-10-10T22:16:16.425Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-11T22:16:16.425Z","lastVerifiedAt":null,"highlights":[{"version":"3.0.1","createdAt":"2026-03-24T01:44:26.264Z","changelog":"Fix description","fileCount":4,"zipByteSize":4970},{"version":"3.0.0","createdAt":"2026-03-23T00:58:34.255Z","changelog":"Clean package","fileCount":3,"zipByteSize":3895},{"version":"2.0.1","createdAt":"2026-03-18T10:49:49.249Z","changelog":"update","fileCount":3,"zipByteSize":3685},{"version":"2.0.0","createdAt":"2026-03-17T18:50:43.087Z","changelog":"v2.5 standard: Use-when desc, homepage, source, security fix","fileCount":5,"zipByteSize":8391},{"version":"2.3.5","createdAt":"2026-03-16T13:16:00.086Z","changelog":"yaml-fix+quality","fileCount":5,"zipByteSize":8409},{"version":"2.3.4","createdAt":"2026-03-16T12:10:14.555Z","changelog":"yaml-fix+quality","fileCount":5,"zipByteSize":8409},{"version":"2.3.3","createdAt":"2026-03-15T22:41:23.507Z","changelog":"Quality upgrade","fileCount":4,"zipByteSize":7403},{"version":"2.3.2","createdAt":"2026-03-15T21:55:11.789Z","changelog":"Quality upgrade: custom functionality","fileCount":4,"zipByteSize":7404}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s174pq5f3gzez3838vt2642fmx848f1d:roomba-control","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-roomba-control/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-roomba-control/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-roomba-control/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-roomba-control/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-roomba-control/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-roomba-control/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-11T00:31:04.926Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-roomba-control/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-roomba-control/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-roomba-control/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-bytesagain-lab-roomba-control/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-10T22:16:16.496Z","emptyReason":null},"readme":"Skill: Roomba Control\n\nOwner: bytesagain-lab\n\nSummary: Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Roomba Control concepts, best practices, and implementation patterns.\n\nTags: chinese:1.0.0, latest:3.0.1, productivity:1.0.0\n\nVersion history:\n\nv3.0.1 | 2026-03-24T01:44:26.264Z | user\n\nFix description\n\nv3.0.0 | 2026-03-23T00:58:34.255Z | user\n\nClean package\n\nv2.0.1 | 2026-03-18T10:49:49.249Z | user\n\nupdate\n\nv2.0.0 | 2026-03-17T18:50:43.087Z | user\n\nv2.5 standard: Use-when desc, homepage, source, security fix\n\nv2.3.5 | 2026-03-16T13:16:00.086Z | user\n\nyaml-fix+quality\n\nv2.3.4 | 2026-03-16T12:10:14.555Z | user\n\nyaml-fix+quality\n\nv2.3.3 | 2026-03-15T22:41:23.507Z | user\n\nQuality upgrade\n\nv2.3.2 | 2026-03-15T21:55:11.789Z | user\n\nQuality upgrade: custom functionality\n\nv2.3.1 | 2026-03-15T01:46:50.719Z | user\n\nQuality update: docs, examples, standards compliance\n\nv2.3.0 | 2026-03-14T00:21:13.894Z | user\n\nQuality fixes: removed third-party references, aligned docs with implementation\n\nv2.2.0 | 2026-03-13T17:09:20.237Z | user\n\nEnhanced descriptions for better AI triggering\n\nv2.1.0 | 2026-03-13T16:54:31.638Z | user\n\nEnhanced descriptions for better AI triggering\n\nv1.0.2 | 2026-03-13T00:27:14.115Z | user\n\nRuntime fix\n\nv1.0.1 | 2026-03-13T00:13:37.656Z | user\n\nAdd runtime declaration + security compliance\n\nv1.0.0 | 2026-03-11T11:18:28.654Z | auto\n\nInitial release of Roomba Control skill.\n\n- Control iRobot Roomba vacuums from the terminal using the cloud API.\n- Start, stop, pause, and schedule cleaning jobs, including specific rooms.\n- Monitor consumable status and receive alerts for parts needing replacement.\n- View cleaning history, detailed stats, and ASCII coverage maps.\n- Support for multiple robots with switching and bulk actions.\n- Designed for scripting and automation (cron, notifications, etc.).\n\nArchive index:\n\nArchive v3.0.1: 4 files, 4970 bytes\n\nFiles: scripts/script.sh (7018b), skill-card.md (1759b), SKILL.md (1184b), _meta.json (133b)\n\nFile v3.0.1:SKILL.md\n\n---\nname: \"roomba-control\"\nversion: \"3.0.1\"\ndescription: \"Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Roomba Control concepts, best practices, and implementation patterns.\"\nauthor: \"BytesAgain\"\nhomepage: \"https://bytesagain.com\"\nsource: \"https://github.com/bytesagain/ai-skills\"\ntags: [roomba,control, reference]\ncategory: \"life\"\n---\n\n# Roomba Control\n\nReference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Roomba Control concepts, best practices, and implementation patterns. No API keys or credentials required.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `intro` | intro reference |\n| `quickstart` | quickstart reference |\n| `patterns` | patterns reference |\n| `debugging` | debugging reference |\n| `performance` | performance reference |\n| `security` | security reference |\n| `migration` | migration reference |\n| `cheatsheet` | cheatsheet reference |\n\n## Output Format\n\nAll commands output plain-text reference documentation via heredoc. No external API calls, no credentials needed, no network access.\n\n---\n\n*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*\n\nFile v3.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"roomba-control\",\n  \"version\": \"3.0.1\",\n  \"publishedAt\": 1774316666264\n}\n\nFile v3.0.1:skill-card.md\n\n## Description:\n\nReference tool for life - covers intro, quickstart, patterns and more. Quick lookup for Roomba Control concepts, best practices, and implementation patterns.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[bytesagain-lab](https://clawhub.ai/user/bytesagain-lab)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and external users use this skill for quick plain-text reference material about Roomba Control concepts, commands, troubleshooting, security, migration, and related patterns.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The server security guidance notes that the content appears generic despite being branded as Roomba Control.\n\nMitigation: Review the reference text for domain accuracy before relying on it or publishing it as product-specific guidance.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/bytesagain-lab/skills/roomba-control)\n- [BytesAgain homepage](https://bytesagain.com)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]\n\n**Output Format:** [Plain text and Markdown-style reference documentation emitted by shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Static command-specific reference output; evidence.security reports no credentials, network access, file access, or persistent system changes.]\n\n## Skill Version(s):\n\n3.0.1 (source: server release metadata and SKILL.md frontmatter)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.\n\nArchive v3.0.0: 3 files, 3895 bytes\n\nFiles: scripts/script.sh (7018b), SKILL.md (950b), _meta.json (133b)\n\nFile v3.0.0:SKILL.md\n\n---\nname: \"roomba-control\"\nversion: \"3.0.0\"\ndescription: \"Powered by BytesAgain\"\nauthor: \"BytesAgain\"\nhomepage: \"https://bytesagain.com\"\nsource: \"https://github.com/bytesagain/ai-skills\"\ntags: [roomba,control, reference]\ncategory: \"life\"\n---\n\n# Roomba Control\n\nPowered by BytesAgain. No API keys or credentials required — outputs reference documentation only.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `intro` | intro reference |\n| `quickstart` | quickstart reference |\n| `patterns` | patterns reference |\n| `debugging` | debugging reference |\n| `performance` | performance reference |\n| `security` | security reference |\n| `migration` | migration reference |\n| `cheatsheet` | cheatsheet reference |\n\n## Output Format\n\nAll commands output plain-text reference documentation via heredoc. No external API calls, no credentials needed, no network access.\n\n---\n\n*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*\n\nFile v3.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"roomba-control\",\n  \"version\": \"3.0.0\",\n  \"publishedAt\": 1774227514255\n}\n\nArchive v2.0.1: 3 files, 3685 bytes\n\nFiles: scripts/script.sh (2253b), SKILL.md (6142b), _meta.json (133b)\n\nFile v2.0.1:SKILL.md\n\n---\nversion: \"2.0.0\"\nname: roomba-control\ndescription: \"Command iRobot Roomba vacuums from the terminal. Use when starting cleans, configuring maps, checking status, listing schedules, adding no-go zones.\"\nauthor: BytesAgain\nhomepage: https://bytesagain.com\nsource: https://github.com/bytesagain/ai-skills\n---\n\n# Roomba Control\n\nCommand your iRobot Roomba from the terminal.\n\n---\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [Configuration](#configuration)\n- [Core Commands](#core-commands)\n- [Cleaning Jobs](#cleaning-jobs)\n- [Scheduling](#scheduling)\n- [Consumable Tracking](#consumable-tracking)\n- [Cleaning History & Maps](#cleaning-history--maps)\n- [Multi-Robot Support](#multi-robot-support)\n- [Scripting & Automation](#scripting--automation)\n\n---\n\n## Requirements\n\n- An iRobot Roomba with Wi-Fi connectivity (600/700/800/900/i/j/s series)\n- iRobot account credentials\n- Python 3.6+\n- Network access to iRobot cloud services\n\n## Configuration\n\n```bash\nexport IROBOT_EMAIL=\"you@example.com\"\nexport IROBOT_PASSWORD=\"your-password\"\n```\n\nFirst-time setup discovers your robots:\n\n```bash\n$ bash scripts/roomba-ctl.sh setup\n\nDiscovering robots on your account...\nFound 2 robots:\n  [1] Rosie       — Roomba j7+    (Online, Docked)\n  [2] Dusty       — Roomba i3     (Online, Docked)\n\nConfiguration saved to ~/.roomba-control/config.json\nDefault robot set to: Rosie\n```\n\n---\n\n## Core Commands\n\n```bash\n# Robot status\nbash scripts/roomba-ctl.sh status\n# Output: Rosie (j7+) | Docked | Battery: 94% | Last clean: 2h ago | Bin: OK\n\n# Detailed info\nbash scripts/roomba-ctl.sh info\n\n# Network/connectivity check\nbash scripts/roomba-ctl.sh ping\n\n# Identify robot (plays a sound)\nbash scripts/roomba-ctl.sh find\n```\n\n---\n\n## Cleaning Jobs\n\n### Start & Stop\n\n```bash\n# Start cleaning (full house)\nbash scripts/roomba-ctl.sh clean\n\n# Clean specific rooms (requires room-mapping capable models)\nbash scripts/roomba-ctl.sh clean --rooms \"Kitchen,Living Room\"\n\n# Pause current job\nbash scripts/roomba-ctl.sh pause\n\n# Resume paused job\nbash scripts/roomba-ctl.sh resume\n\n# Send back to dock\nbash scripts/roomba-ctl.sh dock\n\n# Emergency stop\nbash scripts/roomba-ctl.sh stop\n```\n\n### Job Monitoring\n\n```bash\n# Current job progress\nbash scripts/roomba-ctl.sh progress\n# Output: Cleaning... 65% complete | 23 min elapsed | Kitchen ✓ | Living Room (in progress)\n\n# Follow job in real-time (updates every 30s)\nbash scripts/roomba-ctl.sh progress --follow\n```\n\n---\n\n## Scheduling\n\n```bash\n# View current schedule\nbash scripts/roomba-ctl.sh schedule\n\n# Set daily schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00\n\n# Set weekday-only schedule\nbash scripts/roomba-ctl.sh schedule set --weekdays 10:00\n\n# Custom schedule\nbash scripts/roomba-ctl.sh schedule set --days mon,wed,fri --time 14:00\n\n# Specific rooms on schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00 --rooms \"Kitchen,Hallway\"\n\n# Disable schedule\nbash scripts/roomba-ctl.sh schedule off\n\n# Enable schedule\nbash scripts/roomba-ctl.sh schedule on\n```\n\n---\n\n## Consumable Tracking\n\nKeep tabs on parts that need replacement.\n\n```bash\n$ bash scripts/roomba-ctl.sh consumables\n\nConsumable Status — Rosie (j7+)\n────────────────────────────────────\nMain Brush:     ████████░░ 78%   (~44 hours remaining)\nSide Brush:     █████░░░░░ 52%   (~26 hours remaining)\nFilter:         ███░░░░░░░ 31%   (~15 hours remaining)  ⚠️ Replace soon\nBin:            Full — Empty before next clean\nDust Bag:       ███████░░░ 68%   (auto-empty base)\n\nEstimated based on 6.2 hrs/week average usage.\n```\n\n```bash\n# Alert if any consumable below threshold\nbash scripts/roomba-ctl.sh consumables --alert 20\n# Exit code 1 if any below 20%\n\n# Reset consumable counter after replacement\nbash scripts/roomba-ctl.sh consumables reset filter\nbash scripts/roomba-ctl.sh consumables reset main_brush\n```\n\n---\n\n## Cleaning History & Maps\n\n```bash\n# Recent cleaning sessions\nbash scripts/roomba-ctl.sh history\nbash scripts/roomba-ctl.sh history --limit 20\n\n# Detailed session report\nbash scripts/roomba-ctl.sh history <session_id>\n\n# Cleaning statistics\nbash scripts/roomba-ctl.sh stats\n# Output: This week: 4 cleans, 3.2 hrs, 1,240 sq ft avg\n#         This month: 14 cleans, 11.8 hrs, 1,180 sq ft avg\n#         Lifetime: 342 cleans, 298.5 hrs\n\n# Export history as CSV\nbash scripts/roomba-ctl.sh history export cleaning_log.csv --days 90\n\n# Coverage map (ASCII visualization)\nbash scripts/roomba-ctl.sh map\n```\n\n---\n\n## Multi-Robot Support\n\n```bash\n# List all robots\nbash scripts/roomba-ctl.sh robots\n\n# Switch default robot\nbash scripts/roomba-ctl.sh use \"Dusty\"\n\n# Command a specific robot\nbash scripts/roomba-ctl.sh --robot \"Dusty\" clean\n\n# Start all robots\nbash scripts/roomba-ctl.sh clean --all\n\n# Status of all robots\nbash scripts/roomba-ctl.sh status --all\n```\n\n---\n\n## Scripting & Automation\n\n**Clean before guests arrive (cron):**\n```bash\n# Friday at 4 PM — clean living areas\n0 16 * * 5 bash /path/to/roomba-ctl.sh clean --rooms \"Living Room,Dining Room,Kitchen\"\n```\n\n**Post-clean notification:**\n```bash\nbash scripts/roomba-ctl.sh clean\nwhile bash scripts/roomba-ctl.sh status --raw | grep -q \"running\"; do sleep 60; done\necho \"Cleaning complete!\" | mail -s \"Roomba Done\" you@email.com\n```\n\n**Consumable shopping reminder:**\n```bash\nLOW=$(bash scripts/roomba-ctl.sh consumables --alert 25 --names)\nif [ -n \"$LOW\" ]; then\n  echo \"Time to order: $LOW\" | mail -s \"Roomba Parts Needed\" you@email.com\nfi\n```\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n| Command | Description |\n|---------|-------------|\n| `setup` | Configuration instructions |\n| `status` | Full robot status + consumables |\n| `clean` | Clean |\n| `dock` | Send to charging dock |\n| `pause` | Pause |\n| `resume` | Resume |\n| `schedule` | Schedule |\n| `history` | View cleaning history |\n\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\nRun `roomba-control help` to see all available commands.\n\nFile v2.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"roomba-control\",\n  \"version\": \"2.0.1\",\n  \"publishedAt\": 1773830989249\n}\n\nArchive v2.0.0: 5 files, 8391 bytes\n\nFiles: scripts/roomba.sh (9773b), scripts/script.sh (2253b), SKILL.md (6103b), tips.md (2106b), _meta.json (133b)\n\nFile v2.0.0:SKILL.md\n\n---\nversion: \"2.0.0\"\nname: roomba-control\ndescription: \"Manage iRobot Roomba vacuums via the cloud API. Start/stop/schedule cleaning jobs, monitor consumable status.\"\nauthor: BytesAgain\nhomepage: https://bytesagain.com\nsource: https://github.com/bytesagain/ai-skills\n---\n\n# Roomba Control\n\nCommand your iRobot Roomba from the terminal.\n\n---\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [Configuration](#configuration)\n- [Core Commands](#core-commands)\n- [Cleaning Jobs](#cleaning-jobs)\n- [Scheduling](#scheduling)\n- [Consumable Tracking](#consumable-tracking)\n- [Cleaning History & Maps](#cleaning-history--maps)\n- [Multi-Robot Support](#multi-robot-support)\n- [Scripting & Automation](#scripting--automation)\n\n---\n\n## Requirements\n\n- An iRobot Roomba with Wi-Fi connectivity (600/700/800/900/i/j/s series)\n- iRobot account credentials\n- Python 3.6+\n- Network access to iRobot cloud services\n\n## Configuration\n\n```bash\nexport IROBOT_EMAIL=\"you@example.com\"\nexport IROBOT_PASSWORD=\"your-password\"\n```\n\nFirst-time setup discovers your robots:\n\n```bash\n$ bash scripts/roomba-ctl.sh setup\n\nDiscovering robots on your account...\nFound 2 robots:\n  [1] Rosie       — Roomba j7+    (Online, Docked)\n  [2] Dusty       — Roomba i3     (Online, Docked)\n\nConfiguration saved to ~/.roomba-control/config.json\nDefault robot set to: Rosie\n```\n\n---\n\n## Core Commands\n\n```bash\n# Robot status\nbash scripts/roomba-ctl.sh status\n# Output: Rosie (j7+) | Docked | Battery: 94% | Last clean: 2h ago | Bin: OK\n\n# Detailed info\nbash scripts/roomba-ctl.sh info\n\n# Network/connectivity check\nbash scripts/roomba-ctl.sh ping\n\n# Identify robot (plays a sound)\nbash scripts/roomba-ctl.sh find\n```\n\n---\n\n## Cleaning Jobs\n\n### Start & Stop\n\n```bash\n# Start cleaning (full house)\nbash scripts/roomba-ctl.sh clean\n\n# Clean specific rooms (requires room-mapping capable models)\nbash scripts/roomba-ctl.sh clean --rooms \"Kitchen,Living Room\"\n\n# Pause current job\nbash scripts/roomba-ctl.sh pause\n\n# Resume paused job\nbash scripts/roomba-ctl.sh resume\n\n# Send back to dock\nbash scripts/roomba-ctl.sh dock\n\n# Emergency stop\nbash scripts/roomba-ctl.sh stop\n```\n\n### Job Monitoring\n\n```bash\n# Current job progress\nbash scripts/roomba-ctl.sh progress\n# Output: Cleaning... 65% complete | 23 min elapsed | Kitchen ✓ | Living Room (in progress)\n\n# Follow job in real-time (updates every 30s)\nbash scripts/roomba-ctl.sh progress --follow\n```\n\n---\n\n## Scheduling\n\n```bash\n# View current schedule\nbash scripts/roomba-ctl.sh schedule\n\n# Set daily schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00\n\n# Set weekday-only schedule\nbash scripts/roomba-ctl.sh schedule set --weekdays 10:00\n\n# Custom schedule\nbash scripts/roomba-ctl.sh schedule set --days mon,wed,fri --time 14:00\n\n# Specific rooms on schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00 --rooms \"Kitchen,Hallway\"\n\n# Disable schedule\nbash scripts/roomba-ctl.sh schedule off\n\n# Enable schedule\nbash scripts/roomba-ctl.sh schedule on\n```\n\n---\n\n## Consumable Tracking\n\nKeep tabs on parts that need replacement.\n\n```bash\n$ bash scripts/roomba-ctl.sh consumables\n\nConsumable Status — Rosie (j7+)\n────────────────────────────────────\nMain Brush:     ████████░░ 78%   (~44 hours remaining)\nSide Brush:     █████░░░░░ 52%   (~26 hours remaining)\nFilter:         ███░░░░░░░ 31%   (~15 hours remaining)  ⚠️ Replace soon\nBin:            Full — Empty before next clean\nDust Bag:       ███████░░░ 68%   (auto-empty base)\n\nEstimated based on 6.2 hrs/week average usage.\n```\n\n```bash\n# Alert if any consumable below threshold\nbash scripts/roomba-ctl.sh consumables --alert 20\n# Exit code 1 if any below 20%\n\n# Reset consumable counter after replacement\nbash scripts/roomba-ctl.sh consumables reset filter\nbash scripts/roomba-ctl.sh consumables reset main_brush\n```\n\n---\n\n## Cleaning History & Maps\n\n```bash\n# Recent cleaning sessions\nbash scripts/roomba-ctl.sh history\nbash scripts/roomba-ctl.sh history --limit 20\n\n# Detailed session report\nbash scripts/roomba-ctl.sh history <session_id>\n\n# Cleaning statistics\nbash scripts/roomba-ctl.sh stats\n# Output: This week: 4 cleans, 3.2 hrs, 1,240 sq ft avg\n#         This month: 14 cleans, 11.8 hrs, 1,180 sq ft avg\n#         Lifetime: 342 cleans, 298.5 hrs\n\n# Export history as CSV\nbash scripts/roomba-ctl.sh history export cleaning_log.csv --days 90\n\n# Coverage map (ASCII visualization)\nbash scripts/roomba-ctl.sh map\n```\n\n---\n\n## Multi-Robot Support\n\n```bash\n# List all robots\nbash scripts/roomba-ctl.sh robots\n\n# Switch default robot\nbash scripts/roomba-ctl.sh use \"Dusty\"\n\n# Command a specific robot\nbash scripts/roomba-ctl.sh --robot \"Dusty\" clean\n\n# Start all robots\nbash scripts/roomba-ctl.sh clean --all\n\n# Status of all robots\nbash scripts/roomba-ctl.sh status --all\n```\n\n---\n\n## Scripting & Automation\n\n**Clean before guests arrive (cron):**\n```bash\n# Friday at 4 PM — clean living areas\n0 16 * * 5 bash /path/to/roomba-ctl.sh clean --rooms \"Living Room,Dining Room,Kitchen\"\n```\n\n**Post-clean notification:**\n```bash\nbash scripts/roomba-ctl.sh clean\nwhile bash scripts/roomba-ctl.sh status --raw | grep -q \"running\"; do sleep 60; done\necho \"Cleaning complete!\" | mail -s \"Roomba Done\" you@email.com\n```\n\n**Consumable shopping reminder:**\n```bash\nLOW=$(bash scripts/roomba-ctl.sh consumables --alert 25 --names)\nif [ -n \"$LOW\" ]; then\n  echo \"Time to order: $LOW\" | mail -s \"Roomba Parts Needed\" you@email.com\nfi\n```\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n| Command | Description |\n|---------|-------------|\n| `setup` | Configuration instructions |\n| `status` | Full robot status + consumables |\n| `clean` | Clean |\n| `dock` | Send to charging dock |\n| `pause` | Pause |\n| `resume` | Resume |\n| `schedule` | Schedule |\n| `history` | View cleaning history |\n\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\nRun `roomba-control help` to see all available commands.\n\nFile v2.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"roomba-control\",\n  \"version\": \"2.0.0\",\n  \"publishedAt\": 1773773443087\n}\n\nFile v2.0.0:tips.md\n\n# Tips for Roomba Control\n\n## Getting Better Cleans\n\n1. **Schedule during quiet hours.** The Roomba works best when the house is empty — no feet, pets, or toys to dodge.\n\n2. **Use room-specific cleaning** on supported models (i/j/s series). Targeted runs are faster and more efficient than full-house cleans.\n\n3. **Empty the bin before each clean** (or rely on the auto-empty base if you have one). A full bin significantly reduces suction power.\n\n4. **Check consumables monthly.** The `consumables` command shows remaining life. Replace filters and brushes before they're completely worn to maintain cleaning performance.\n\n5. **Run `stats`** weekly to track cleaning efficiency. Declining coverage area might mean the robot needs maintenance.\n\n## Multi-Room Strategy\n\n- Clean high-traffic areas (kitchen, hallways) daily\n- Clean bedrooms and offices 2-3x per week\n- Do a full-house clean once a week\n- Use `--rooms` to target specific areas per schedule\n\n## Consumable Replacement Schedule\n\n| Part | Typical Lifespan | Signs of Wear |\n|------|------------------|---------------|\n| Filter | 2 months | Visible debris, reduced suction |\n| Side Brush | 2-3 months | Bent/worn bristles |\n| Main Brush | 6-8 months | Frayed bristles, reduced pickup |\n| Dust Bag | 30 days (auto-empty) | Base indicates full |\n\n## Troubleshooting\n\n- **\"Roomba stuck\"** — Check for tangled hair on brushes, stuck wheels, or obstacles. Clear and restart.\n- **\"Charging error\"** — Clean the charging contacts on both the robot and dock with a dry cloth.\n- **Room names not matching** — Names must match exactly what's in the iRobot app, including capitalization.\n- **Wi-Fi disconnects** — Keep the dock within good Wi-Fi range. Consider a Wi-Fi extender if your Pi is far from the router.\n\n## Automation Recipes\n\n- Clean the kitchen 30 minutes after dinner (tie to a calendar event or manual trigger)\n- Run a deep clean before weekly house guests\n- Alert when bin is full so you can empty it before the next scheduled clean\n- Pair with `homeassistant-toolkit` for trigger-based cleaning (e.g., everyone leaves the house)\n\nArchive v2.3.5: 5 files, 8409 bytes\n\nFiles: scripts/roomba.sh (9773b), scripts/script.sh (2253b), SKILL.md (6134b), tips.md (2106b), _meta.json (133b)\n\nFile v2.3.5:SKILL.md\n\n---\nversion: \"2.0.0\"\nname: roomba-control\ndescription: \"Manage iRobot Roomba vacuums via the cloud API. Start/stop/schedule cleaning jobs, monitor consumable status, and view cleaning maps and history. Use when you need roomba control capabilities. Triggers on: roomba control.\"\nauthor: BytesAgain\n---\n\n# Roomba Control\n\nCommand your iRobot Roomba from the terminal.\n\n---\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [Configuration](#configuration)\n- [Core Commands](#core-commands)\n- [Cleaning Jobs](#cleaning-jobs)\n- [Scheduling](#scheduling)\n- [Consumable Tracking](#consumable-tracking)\n- [Cleaning History & Maps](#cleaning-history--maps)\n- [Multi-Robot Support](#multi-robot-support)\n- [Scripting & Automation](#scripting--automation)\n\n---\n\n## Requirements\n\n- An iRobot Roomba with Wi-Fi connectivity (600/700/800/900/i/j/s series)\n- iRobot account credentials\n- Python 3.6+\n- Network access to iRobot cloud services\n\n## Configuration\n\n```bash\nexport IROBOT_EMAIL=\"you@example.com\"\nexport IROBOT_PASSWORD=\"your-password\"\n```\n\nFirst-time setup discovers your robots:\n\n```bash\n$ bash scripts/roomba-ctl.sh setup\n\nDiscovering robots on your account...\nFound 2 robots:\n  [1] Rosie       — Roomba j7+    (Online, Docked)\n  [2] Dusty       — Roomba i3     (Online, Docked)\n\nConfiguration saved to ~/.roomba-control/config.json\nDefault robot set to: Rosie\n```\n\n---\n\n## Core Commands\n\n```bash\n# Robot status\nbash scripts/roomba-ctl.sh status\n# Output: Rosie (j7+) | Docked | Battery: 94% | Last clean: 2h ago | Bin: OK\n\n# Detailed info\nbash scripts/roomba-ctl.sh info\n\n# Network/connectivity check\nbash scripts/roomba-ctl.sh ping\n\n# Identify robot (plays a sound)\nbash scripts/roomba-ctl.sh find\n```\n\n---\n\n## Cleaning Jobs\n\n### Start & Stop\n\n```bash\n# Start cleaning (full house)\nbash scripts/roomba-ctl.sh clean\n\n# Clean specific rooms (requires room-mapping capable models)\nbash scripts/roomba-ctl.sh clean --rooms \"Kitchen,Living Room\"\n\n# Pause current job\nbash scripts/roomba-ctl.sh pause\n\n# Resume paused job\nbash scripts/roomba-ctl.sh resume\n\n# Send back to dock\nbash scripts/roomba-ctl.sh dock\n\n# Emergency stop\nbash scripts/roomba-ctl.sh stop\n```\n\n### Job Monitoring\n\n```bash\n# Current job progress\nbash scripts/roomba-ctl.sh progress\n# Output: Cleaning... 65% complete | 23 min elapsed | Kitchen ✓ | Living Room (in progress)\n\n# Follow job in real-time (updates every 30s)\nbash scripts/roomba-ctl.sh progress --follow\n```\n\n---\n\n## Scheduling\n\n```bash\n# View current schedule\nbash scripts/roomba-ctl.sh schedule\n\n# Set daily schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00\n\n# Set weekday-only schedule\nbash scripts/roomba-ctl.sh schedule set --weekdays 10:00\n\n# Custom schedule\nbash scripts/roomba-ctl.sh schedule set --days mon,wed,fri --time 14:00\n\n# Specific rooms on schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00 --rooms \"Kitchen,Hallway\"\n\n# Disable schedule\nbash scripts/roomba-ctl.sh schedule off\n\n# Enable schedule\nbash scripts/roomba-ctl.sh schedule on\n```\n\n---\n\n## Consumable Tracking\n\nKeep tabs on parts that need replacement.\n\n```bash\n$ bash scripts/roomba-ctl.sh consumables\n\nConsumable Status — Rosie (j7+)\n────────────────────────────────────\nMain Brush:     ████████░░ 78%   (~44 hours remaining)\nSide Brush:     █████░░░░░ 52%   (~26 hours remaining)\nFilter:         ███░░░░░░░ 31%   (~15 hours remaining)  ⚠️ Replace soon\nBin:            Full — Empty before next clean\nDust Bag:       ███████░░░ 68%   (auto-empty base)\n\nEstimated based on 6.2 hrs/week average usage.\n```\n\n```bash\n# Alert if any consumable below threshold\nbash scripts/roomba-ctl.sh consumables --alert 20\n# Exit code 1 if any below 20%\n\n# Reset consumable counter after replacement\nbash scripts/roomba-ctl.sh consumables reset filter\nbash scripts/roomba-ctl.sh consumables reset main_brush\n```\n\n---\n\n## Cleaning History & Maps\n\n```bash\n# Recent cleaning sessions\nbash scripts/roomba-ctl.sh history\nbash scripts/roomba-ctl.sh history --limit 20\n\n# Detailed session report\nbash scripts/roomba-ctl.sh history <session_id>\n\n# Cleaning statistics\nbash scripts/roomba-ctl.sh stats\n# Output: This week: 4 cleans, 3.2 hrs, 1,240 sq ft avg\n#         This month: 14 cleans, 11.8 hrs, 1,180 sq ft avg\n#         Lifetime: 342 cleans, 298.5 hrs\n\n# Export history as CSV\nbash scripts/roomba-ctl.sh history export cleaning_log.csv --days 90\n\n# Coverage map (ASCII visualization)\nbash scripts/roomba-ctl.sh map\n```\n\n---\n\n## Multi-Robot Support\n\n```bash\n# List all robots\nbash scripts/roomba-ctl.sh robots\n\n# Switch default robot\nbash scripts/roomba-ctl.sh use \"Dusty\"\n\n# Command a specific robot\nbash scripts/roomba-ctl.sh --robot \"Dusty\" clean\n\n# Start all robots\nbash scripts/roomba-ctl.sh clean --all\n\n# Status of all robots\nbash scripts/roomba-ctl.sh status --all\n```\n\n---\n\n## Scripting & Automation\n\n**Clean before guests arrive (cron):**\n```bash\n# Friday at 4 PM — clean living areas\n0 16 * * 5 bash /path/to/roomba-ctl.sh clean --rooms \"Living Room,Dining Room,Kitchen\"\n```\n\n**Post-clean notification:**\n```bash\nbash scripts/roomba-ctl.sh clean\nwhile bash scripts/roomba-ctl.sh status --raw | grep -q \"running\"; do sleep 60; done\necho \"Cleaning complete!\" | mail -s \"Roomba Done\" you@email.com\n```\n\n**Consumable shopping reminder:**\n```bash\nLOW=$(bash scripts/roomba-ctl.sh consumables --alert 25 --names)\nif [ -n \"$LOW\" ]; then\n  echo \"Time to order: $LOW\" | mail -s \"Roomba Parts Needed\" you@email.com\nfi\n```\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n| Command | Description |\n|---------|-------------|\n| `setup` | Configuration instructions |\n| `status` | Full robot status + consumables |\n| `clean` | Clean |\n| `dock` | Send to charging dock |\n| `pause` | Pause |\n| `resume` | Resume |\n| `schedule` | Schedule |\n| `history` | View cleaning history |\n\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\nRun `roomba-control help` to see all available commands.\n\nFile v2.3.5:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"roomba-control\",\n  \"version\": \"2.3.5\",\n  \"publishedAt\": 1773666960086\n}\n\nFile v2.3.5:tips.md\n\n# Tips for Roomba Control\n\n## Getting Better Cleans\n\n1. **Schedule during quiet hours.** The Roomba works best when the house is empty — no feet, pets, or toys to dodge.\n\n2. **Use room-specific cleaning** on supported models (i/j/s series). Targeted runs are faster and more efficient than full-house cleans.\n\n3. **Empty the bin before each clean** (or rely on the auto-empty base if you have one). A full bin significantly reduces suction power.\n\n4. **Check consumables monthly.** The `consumables` command shows remaining life. Replace filters and brushes before they're completely worn to maintain cleaning performance.\n\n5. **Run `stats`** weekly to track cleaning efficiency. Declining coverage area might mean the robot needs maintenance.\n\n## Multi-Room Strategy\n\n- Clean high-traffic areas (kitchen, hallways) daily\n- Clean bedrooms and offices 2-3x per week\n- Do a full-house clean once a week\n- Use `--rooms` to target specific areas per schedule\n\n## Consumable Replacement Schedule\n\n| Part | Typical Lifespan | Signs of Wear |\n|------|------------------|---------------|\n| Filter | 2 months | Visible debris, reduced suction |\n| Side Brush | 2-3 months | Bent/worn bristles |\n| Main Brush | 6-8 months | Frayed bristles, reduced pickup |\n| Dust Bag | 30 days (auto-empty) | Base indicates full |\n\n## Troubleshooting\n\n- **\"Roomba stuck\"** — Check for tangled hair on brushes, stuck wheels, or obstacles. Clear and restart.\n- **\"Charging error\"** — Clean the charging contacts on both the robot and dock with a dry cloth.\n- **Room names not matching** — Names must match exactly what's in the iRobot app, including capitalization.\n- **Wi-Fi disconnects** — Keep the dock within good Wi-Fi range. Consider a Wi-Fi extender if your Pi is far from the router.\n\n## Automation Recipes\n\n- Clean the kitchen 30 minutes after dinner (tie to a calendar event or manual trigger)\n- Run a deep clean before weekly house guests\n- Alert when bin is full so you can empty it before the next scheduled clean\n- Pair with `homeassistant-toolkit` for trigger-based cleaning (e.g., everyone leaves the house)\n\nArchive v2.3.4: 5 files, 8409 bytes\n\nFiles: scripts/roomba.sh (9773b), scripts/script.sh (2253b), SKILL.md (6134b), tips.md (2106b), _meta.json (133b)\n\nFile v2.3.4:SKILL.md\n\n---\nversion: \"2.0.0\"\nname: roomba-control\ndescription: \"Manage iRobot Roomba vacuums via the cloud API. Start/stop/schedule cleaning jobs, monitor consumable status, and view cleaning maps and history. Use when you need roomba control capabilities. Triggers on: roomba control.\"\nauthor: BytesAgain\n---\n\n# Roomba Control\n\nCommand your iRobot Roomba from the terminal.\n\n---\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [Configuration](#configuration)\n- [Core Commands](#core-commands)\n- [Cleaning Jobs](#cleaning-jobs)\n- [Scheduling](#scheduling)\n- [Consumable Tracking](#consumable-tracking)\n- [Cleaning History & Maps](#cleaning-history--maps)\n- [Multi-Robot Support](#multi-robot-support)\n- [Scripting & Automation](#scripting--automation)\n\n---\n\n## Requirements\n\n- An iRobot Roomba with Wi-Fi connectivity (600/700/800/900/i/j/s series)\n- iRobot account credentials\n- Python 3.6+\n- Network access to iRobot cloud services\n\n## Configuration\n\n```bash\nexport IROBOT_EMAIL=\"you@example.com\"\nexport IROBOT_PASSWORD=\"your-password\"\n```\n\nFirst-time setup discovers your robots:\n\n```bash\n$ bash scripts/roomba-ctl.sh setup\n\nDiscovering robots on your account...\nFound 2 robots:\n  [1] Rosie       — Roomba j7+    (Online, Docked)\n  [2] Dusty       — Roomba i3     (Online, Docked)\n\nConfiguration saved to ~/.roomba-control/config.json\nDefault robot set to: Rosie\n```\n\n---\n\n## Core Commands\n\n```bash\n# Robot status\nbash scripts/roomba-ctl.sh status\n# Output: Rosie (j7+) | Docked | Battery: 94% | Last clean: 2h ago | Bin: OK\n\n# Detailed info\nbash scripts/roomba-ctl.sh info\n\n# Network/connectivity check\nbash scripts/roomba-ctl.sh ping\n\n# Identify robot (plays a sound)\nbash scripts/roomba-ctl.sh find\n```\n\n---\n\n## Cleaning Jobs\n\n### Start & Stop\n\n```bash\n# Start cleaning (full house)\nbash scripts/roomba-ctl.sh clean\n\n# Clean specific rooms (requires room-mapping capable models)\nbash scripts/roomba-ctl.sh clean --rooms \"Kitchen,Living Room\"\n\n# Pause current job\nbash scripts/roomba-ctl.sh pause\n\n# Resume paused job\nbash scripts/roomba-ctl.sh resume\n\n# Send back to dock\nbash scripts/roomba-ctl.sh dock\n\n# Emergency stop\nbash scripts/roomba-ctl.sh stop\n```\n\n### Job Monitoring\n\n```bash\n# Current job progress\nbash scripts/roomba-ctl.sh progress\n# Output: Cleaning... 65% complete | 23 min elapsed | Kitchen ✓ | Living Room (in progress)\n\n# Follow job in real-time (updates every 30s)\nbash scripts/roomba-ctl.sh progress --follow\n```\n\n---\n\n## Scheduling\n\n```bash\n# View current schedule\nbash scripts/roomba-ctl.sh schedule\n\n# Set daily schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00\n\n# Set weekday-only schedule\nbash scripts/roomba-ctl.sh schedule set --weekdays 10:00\n\n# Custom schedule\nbash scripts/roomba-ctl.sh schedule set --days mon,wed,fri --time 14:00\n\n# Specific rooms on schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00 --rooms \"Kitchen,Hallway\"\n\n# Disable schedule\nbash scripts/roomba-ctl.sh schedule off\n\n# Enable schedule\nbash scripts/roomba-ctl.sh schedule on\n```\n\n---\n\n## Consumable Tracking\n\nKeep tabs on parts that need replacement.\n\n```bash\n$ bash scripts/roomba-ctl.sh consumables\n\nConsumable Status — Rosie (j7+)\n────────────────────────────────────\nMain Brush:     ████████░░ 78%   (~44 hours remaining)\nSide Brush:     █████░░░░░ 52%   (~26 hours remaining)\nFilter:         ███░░░░░░░ 31%   (~15 hours remaining)  ⚠️ Replace soon\nBin:            Full — Empty before next clean\nDust Bag:       ███████░░░ 68%   (auto-empty base)\n\nEstimated based on 6.2 hrs/week average usage.\n```\n\n```bash\n# Alert if any consumable below threshold\nbash scripts/roomba-ctl.sh consumables --alert 20\n# Exit code 1 if any below 20%\n\n# Reset consumable counter after replacement\nbash scripts/roomba-ctl.sh consumables reset filter\nbash scripts/roomba-ctl.sh consumables reset main_brush\n```\n\n---\n\n## Cleaning History & Maps\n\n```bash\n# Recent cleaning sessions\nbash scripts/roomba-ctl.sh history\nbash scripts/roomba-ctl.sh history --limit 20\n\n# Detailed session report\nbash scripts/roomba-ctl.sh history <session_id>\n\n# Cleaning statistics\nbash scripts/roomba-ctl.sh stats\n# Output: This week: 4 cleans, 3.2 hrs, 1,240 sq ft avg\n#         This month: 14 cleans, 11.8 hrs, 1,180 sq ft avg\n#         Lifetime: 342 cleans, 298.5 hrs\n\n# Export history as CSV\nbash scripts/roomba-ctl.sh history export cleaning_log.csv --days 90\n\n# Coverage map (ASCII visualization)\nbash scripts/roomba-ctl.sh map\n```\n\n---\n\n## Multi-Robot Support\n\n```bash\n# List all robots\nbash scripts/roomba-ctl.sh robots\n\n# Switch default robot\nbash scripts/roomba-ctl.sh use \"Dusty\"\n\n# Command a specific robot\nbash scripts/roomba-ctl.sh --robot \"Dusty\" clean\n\n# Start all robots\nbash scripts/roomba-ctl.sh clean --all\n\n# Status of all robots\nbash scripts/roomba-ctl.sh status --all\n```\n\n---\n\n## Scripting & Automation\n\n**Clean before guests arrive (cron):**\n```bash\n# Friday at 4 PM — clean living areas\n0 16 * * 5 bash /path/to/roomba-ctl.sh clean --rooms \"Living Room,Dining Room,Kitchen\"\n```\n\n**Post-clean notification:**\n```bash\nbash scripts/roomba-ctl.sh clean\nwhile bash scripts/roomba-ctl.sh status --raw | grep -q \"running\"; do sleep 60; done\necho \"Cleaning complete!\" | mail -s \"Roomba Done\" you@email.com\n```\n\n**Consumable shopping reminder:**\n```bash\nLOW=$(bash scripts/roomba-ctl.sh consumables --alert 25 --names)\nif [ -n \"$LOW\" ]; then\n  echo \"Time to order: $LOW\" | mail -s \"Roomba Parts Needed\" you@email.com\nfi\n```\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n| Command | Description |\n|---------|-------------|\n| `setup` | Configuration instructions |\n| `status` | Full robot status + consumables |\n| `clean` | Clean |\n| `dock` | Send to charging dock |\n| `pause` | Pause |\n| `resume` | Resume |\n| `schedule` | Schedule |\n| `history` | View cleaning history |\n\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\nRun `roomba-control help` to see all available commands.\n\nFile v2.3.4:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"roomba-control\",\n  \"version\": \"2.3.4\",\n  \"publishedAt\": 1773663014555\n}\n\nFile v2.3.4:tips.md\n\n# Tips for Roomba Control\n\n## Getting Better Cleans\n\n1. **Schedule during quiet hours.** The Roomba works best when the house is empty — no feet, pets, or toys to dodge.\n\n2. **Use room-specific cleaning** on supported models (i/j/s series). Targeted runs are faster and more efficient than full-house cleans.\n\n3. **Empty the bin before each clean** (or rely on the auto-empty base if you have one). A full bin significantly reduces suction power.\n\n4. **Check consumables monthly.** The `consumables` command shows remaining life. Replace filters and brushes before they're completely worn to maintain cleaning performance.\n\n5. **Run `stats`** weekly to track cleaning efficiency. Declining coverage area might mean the robot needs maintenance.\n\n## Multi-Room Strategy\n\n- Clean high-traffic areas (kitchen, hallways) daily\n- Clean bedrooms and offices 2-3x per week\n- Do a full-house clean once a week\n- Use `--rooms` to target specific areas per schedule\n\n## Consumable Replacement Schedule\n\n| Part | Typical Lifespan | Signs of Wear |\n|------|------------------|---------------|\n| Filter | 2 months | Visible debris, reduced suction |\n| Side Brush | 2-3 months | Bent/worn bristles |\n| Main Brush | 6-8 months | Frayed bristles, reduced pickup |\n| Dust Bag | 30 days (auto-empty) | Base indicates full |\n\n## Troubleshooting\n\n- **\"Roomba stuck\"** — Check for tangled hair on brushes, stuck wheels, or obstacles. Clear and restart.\n- **\"Charging error\"** — Clean the charging contacts on both the robot and dock with a dry cloth.\n- **Room names not matching** — Names must match exactly what's in the iRobot app, including capitalization.\n- **Wi-Fi disconnects** — Keep the dock within good Wi-Fi range. Consider a Wi-Fi extender if your Pi is far from the router.\n\n## Automation Recipes\n\n- Clean the kitchen 30 minutes after dinner (tie to a calendar event or manual trigger)\n- Run a deep clean before weekly house guests\n- Alert when bin is full so you can empty it before the next scheduled clean\n- Pair with `homeassistant-toolkit` for trigger-based cleaning (e.g., everyone leaves the house)\n\nArchive v2.3.3: 4 files, 7403 bytes\n\nFiles: scripts/roomba.sh (9773b), SKILL.md (6098b), tips.md (2106b), _meta.json (133b)\n\nFile v2.3.3:SKILL.md\n\n---\nname: roomba-control\ndescription: \"Manage iRobot Roomba vacuums via the cloud API. Start/stop/schedule cleaning jobs, monitor consumable status, and view cleaning maps and history. Use when you need roomba control capabilities. Triggers on: roomba control.\"\n---\n\n# Roomba Control\n\nCommand your iRobot Roomba from the terminal.\n\n---\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [Configuration](#configuration)\n- [Core Commands](#core-commands)\n- [Cleaning Jobs](#cleaning-jobs)\n- [Scheduling](#scheduling)\n- [Consumable Tracking](#consumable-tracking)\n- [Cleaning History & Maps](#cleaning-history--maps)\n- [Multi-Robot Support](#multi-robot-support)\n- [Scripting & Automation](#scripting--automation)\n\n---\n\n## Requirements\n\n- An iRobot Roomba with Wi-Fi connectivity (600/700/800/900/i/j/s series)\n- iRobot account credentials\n- Python 3.6+\n- Network access to iRobot cloud services\n\n## Configuration\n\n```bash\nexport IROBOT_EMAIL=\"you@example.com\"\nexport IROBOT_PASSWORD=\"your-password\"\n```\n\nFirst-time setup discovers your robots:\n\n```bash\n$ bash scripts/roomba-ctl.sh setup\n\nDiscovering robots on your account...\nFound 2 robots:\n  [1] Rosie       — Roomba j7+    (Online, Docked)\n  [2] Dusty       — Roomba i3     (Online, Docked)\n\nConfiguration saved to ~/.roomba-control/config.json\nDefault robot set to: Rosie\n```\n\n---\n\n## Core Commands\n\n```bash\n# Robot status\nbash scripts/roomba-ctl.sh status\n# Output: Rosie (j7+) | Docked | Battery: 94% | Last clean: 2h ago | Bin: OK\n\n# Detailed info\nbash scripts/roomba-ctl.sh info\n\n# Network/connectivity check\nbash scripts/roomba-ctl.sh ping\n\n# Identify robot (plays a sound)\nbash scripts/roomba-ctl.sh find\n```\n\n---\n\n## Cleaning Jobs\n\n### Start & Stop\n\n```bash\n# Start cleaning (full house)\nbash scripts/roomba-ctl.sh clean\n\n# Clean specific rooms (requires room-mapping capable models)\nbash scripts/roomba-ctl.sh clean --rooms \"Kitchen,Living Room\"\n\n# Pause current job\nbash scripts/roomba-ctl.sh pause\n\n# Resume paused job\nbash scripts/roomba-ctl.sh resume\n\n# Send back to dock\nbash scripts/roomba-ctl.sh dock\n\n# Emergency stop\nbash scripts/roomba-ctl.sh stop\n```\n\n### Job Monitoring\n\n```bash\n# Current job progress\nbash scripts/roomba-ctl.sh progress\n# Output: Cleaning... 65% complete | 23 min elapsed | Kitchen ✓ | Living Room (in progress)\n\n# Follow job in real-time (updates every 30s)\nbash scripts/roomba-ctl.sh progress --follow\n```\n\n---\n\n## Scheduling\n\n```bash\n# View current schedule\nbash scripts/roomba-ctl.sh schedule\n\n# Set daily schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00\n\n# Set weekday-only schedule\nbash scripts/roomba-ctl.sh schedule set --weekdays 10:00\n\n# Custom schedule\nbash scripts/roomba-ctl.sh schedule set --days mon,wed,fri --time 14:00\n\n# Specific rooms on schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00 --rooms \"Kitchen,Hallway\"\n\n# Disable schedule\nbash scripts/roomba-ctl.sh schedule off\n\n# Enable schedule\nbash scripts/roomba-ctl.sh schedule on\n```\n\n---\n\n## Consumable Tracking\n\nKeep tabs on parts that need replacement.\n\n```bash\n$ bash scripts/roomba-ctl.sh consumables\n\nConsumable Status — Rosie (j7+)\n────────────────────────────────────\nMain Brush:     ████████░░ 78%   (~44 hours remaining)\nSide Brush:     █████░░░░░ 52%   (~26 hours remaining)\nFilter:         ███░░░░░░░ 31%   (~15 hours remaining)  ⚠️ Replace soon\nBin:            Full — Empty before next clean\nDust Bag:       ███████░░░ 68%   (auto-empty base)\n\nEstimated based on 6.2 hrs/week average usage.\n```\n\n```bash\n# Alert if any consumable below threshold\nbash scripts/roomba-ctl.sh consumables --alert 20\n# Exit code 1 if any below 20%\n\n# Reset consumable counter after replacement\nbash scripts/roomba-ctl.sh consumables reset filter\nbash scripts/roomba-ctl.sh consumables reset main_brush\n```\n\n---\n\n## Cleaning History & Maps\n\n```bash\n# Recent cleaning sessions\nbash scripts/roomba-ctl.sh history\nbash scripts/roomba-ctl.sh history --limit 20\n\n# Detailed session report\nbash scripts/roomba-ctl.sh history <session_id>\n\n# Cleaning statistics\nbash scripts/roomba-ctl.sh stats\n# Output: This week: 4 cleans, 3.2 hrs, 1,240 sq ft avg\n#         This month: 14 cleans, 11.8 hrs, 1,180 sq ft avg\n#         Lifetime: 342 cleans, 298.5 hrs\n\n# Export history as CSV\nbash scripts/roomba-ctl.sh history export cleaning_log.csv --days 90\n\n# Coverage map (ASCII visualization)\nbash scripts/roomba-ctl.sh map\n```\n\n---\n\n## Multi-Robot Support\n\n```bash\n# List all robots\nbash scripts/roomba-ctl.sh robots\n\n# Switch default robot\nbash scripts/roomba-ctl.sh use \"Dusty\"\n\n# Command a specific robot\nbash scripts/roomba-ctl.sh --robot \"Dusty\" clean\n\n# Start all robots\nbash scripts/roomba-ctl.sh clean --all\n\n# Status of all robots\nbash scripts/roomba-ctl.sh status --all\n```\n\n---\n\n## Scripting & Automation\n\n**Clean before guests arrive (cron):**\n```bash\n# Friday at 4 PM — clean living areas\n0 16 * * 5 bash /path/to/roomba-ctl.sh clean --rooms \"Living Room,Dining Room,Kitchen\"\n```\n\n**Post-clean notification:**\n```bash\nbash scripts/roomba-ctl.sh clean\nwhile bash scripts/roomba-ctl.sh status --raw | grep -q \"running\"; do sleep 60; done\necho \"Cleaning complete!\" | mail -s \"Roomba Done\" you@email.com\n```\n\n**Consumable shopping reminder:**\n```bash\nLOW=$(bash scripts/roomba-ctl.sh consumables --alert 25 --names)\nif [ -n \"$LOW\" ]; then\n  echo \"Time to order: $LOW\" | mail -s \"Roomba Parts Needed\" you@email.com\nfi\n```\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n| Command | Description |\n|---------|-------------|\n| `setup` | Configuration instructions |\n| `status` | Full robot status + consumables |\n| `clean` | Clean |\n| `dock` | Send to charging dock |\n| `pause` | Pause |\n| `resume` | Resume |\n| `schedule` | Schedule |\n| `history` | View cleaning history |\n\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\nRun `roomba-control help` to see all available commands.\n\nFile v2.3.3:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"roomba-control\",\n  \"version\": \"2.3.3\",\n  \"publishedAt\": 1773614483507\n}\n\nFile v2.3.3:tips.md\n\n# Tips for Roomba Control\n\n## Getting Better Cleans\n\n1. **Schedule during quiet hours.** The Roomba works best when the house is empty — no feet, pets, or toys to dodge.\n\n2. **Use room-specific cleaning** on supported models (i/j/s series). Targeted runs are faster and more efficient than full-house cleans.\n\n3. **Empty the bin before each clean** (or rely on the auto-empty base if you have one). A full bin significantly reduces suction power.\n\n4. **Check consumables monthly.** The `consumables` command shows remaining life. Replace filters and brushes before they're completely worn to maintain cleaning performance.\n\n5. **Run `stats`** weekly to track cleaning efficiency. Declining coverage area might mean the robot needs maintenance.\n\n## Multi-Room Strategy\n\n- Clean high-traffic areas (kitchen, hallways) daily\n- Clean bedrooms and offices 2-3x per week\n- Do a full-house clean once a week\n- Use `--rooms` to target specific areas per schedule\n\n## Consumable Replacement Schedule\n\n| Part | Typical Lifespan | Signs of Wear |\n|------|------------------|---------------|\n| Filter | 2 months | Visible debris, reduced suction |\n| Side Brush | 2-3 months | Bent/worn bristles |\n| Main Brush | 6-8 months | Frayed bristles, reduced pickup |\n| Dust Bag | 30 days (auto-empty) | Base indicates full |\n\n## Troubleshooting\n\n- **\"Roomba stuck\"** — Check for tangled hair on brushes, stuck wheels, or obstacles. Clear and restart.\n- **\"Charging error\"** — Clean the charging contacts on both the robot and dock with a dry cloth.\n- **Room names not matching** — Names must match exactly what's in the iRobot app, including capitalization.\n- **Wi-Fi disconnects** — Keep the dock within good Wi-Fi range. Consider a Wi-Fi extender if your Pi is far from the router.\n\n## Automation Recipes\n\n- Clean the kitchen 30 minutes after dinner (tie to a calendar event or manual trigger)\n- Run a deep clean before weekly house guests\n- Alert when bin is full so you can empty it before the next scheduled clean\n- Pair with `homeassistant-toolkit` for trigger-based cleaning (e.g., everyone leaves the house)\n\nArchive v2.3.2: 4 files, 7404 bytes\n\nFiles: scripts/roomba.sh (9773b), SKILL.md (6098b), tips.md (2106b), _meta.json (133b)\n\nFile v2.3.2:SKILL.md\n\n---\nname: roomba-control\ndescription: \"Manage iRobot Roomba vacuums via the cloud API. Start/stop/schedule cleaning jobs, monitor consumable status, and view cleaning maps and history. Use when you need roomba control capabilities. Triggers on: roomba control.\"\n---\n\n# Roomba Control\n\nCommand your iRobot Roomba from the terminal.\n\n---\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [Configuration](#configuration)\n- [Core Commands](#core-commands)\n- [Cleaning Jobs](#cleaning-jobs)\n- [Scheduling](#scheduling)\n- [Consumable Tracking](#consumable-tracking)\n- [Cleaning History & Maps](#cleaning-history--maps)\n- [Multi-Robot Support](#multi-robot-support)\n- [Scripting & Automation](#scripting--automation)\n\n---\n\n## Requirements\n\n- An iRobot Roomba with Wi-Fi connectivity (600/700/800/900/i/j/s series)\n- iRobot account credentials\n- Python 3.6+\n- Network access to iRobot cloud services\n\n## Configuration\n\n```bash\nexport IROBOT_EMAIL=\"you@example.com\"\nexport IROBOT_PASSWORD=\"your-password\"\n```\n\nFirst-time setup discovers your robots:\n\n```bash\n$ bash scripts/roomba-ctl.sh setup\n\nDiscovering robots on your account...\nFound 2 robots:\n  [1] Rosie       — Roomba j7+    (Online, Docked)\n  [2] Dusty       — Roomba i3     (Online, Docked)\n\nConfiguration saved to ~/.roomba-control/config.json\nDefault robot set to: Rosie\n```\n\n---\n\n## Core Commands\n\n```bash\n# Robot status\nbash scripts/roomba-ctl.sh status\n# Output: Rosie (j7+) | Docked | Battery: 94% | Last clean: 2h ago | Bin: OK\n\n# Detailed info\nbash scripts/roomba-ctl.sh info\n\n# Network/connectivity check\nbash scripts/roomba-ctl.sh ping\n\n# Identify robot (plays a sound)\nbash scripts/roomba-ctl.sh find\n```\n\n---\n\n## Cleaning Jobs\n\n### Start & Stop\n\n```bash\n# Start cleaning (full house)\nbash scripts/roomba-ctl.sh clean\n\n# Clean specific rooms (requires room-mapping capable models)\nbash scripts/roomba-ctl.sh clean --rooms \"Kitchen,Living Room\"\n\n# Pause current job\nbash scripts/roomba-ctl.sh pause\n\n# Resume paused job\nbash scripts/roomba-ctl.sh resume\n\n# Send back to dock\nbash scripts/roomba-ctl.sh dock\n\n# Emergency stop\nbash scripts/roomba-ctl.sh stop\n```\n\n### Job Monitoring\n\n```bash\n# Current job progress\nbash scripts/roomba-ctl.sh progress\n# Output: Cleaning... 65% complete | 23 min elapsed | Kitchen ✓ | Living Room (in progress)\n\n# Follow job in real-time (updates every 30s)\nbash scripts/roomba-ctl.sh progress --follow\n```\n\n---\n\n## Scheduling\n\n```bash\n# View current schedule\nbash scripts/roomba-ctl.sh schedule\n\n# Set daily schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00\n\n# Set weekday-only schedule\nbash scripts/roomba-ctl.sh schedule set --weekdays 10:00\n\n# Custom schedule\nbash scripts/roomba-ctl.sh schedule set --days mon,wed,fri --time 14:00\n\n# Specific rooms on schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00 --rooms \"Kitchen,Hallway\"\n\n# Disable schedule\nbash scripts/roomba-ctl.sh schedule off\n\n# Enable schedule\nbash scripts/roomba-ctl.sh schedule on\n```\n\n---\n\n## Consumable Tracking\n\nKeep tabs on parts that need replacement.\n\n```bash\n$ bash scripts/roomba-ctl.sh consumables\n\nConsumable Status — Rosie (j7+)\n────────────────────────────────────\nMain Brush:     ████████░░ 78%   (~44 hours remaining)\nSide Brush:     █████░░░░░ 52%   (~26 hours remaining)\nFilter:         ███░░░░░░░ 31%   (~15 hours remaining)  ⚠️ Replace soon\nBin:            Full — Empty before next clean\nDust Bag:       ███████░░░ 68%   (auto-empty base)\n\nEstimated based on 6.2 hrs/week average usage.\n```\n\n```bash\n# Alert if any consumable below threshold\nbash scripts/roomba-ctl.sh consumables --alert 20\n# Exit code 1 if any below 20%\n\n# Reset consumable counter after replacement\nbash scripts/roomba-ctl.sh consumables reset filter\nbash scripts/roomba-ctl.sh consumables reset main_brush\n```\n\n---\n\n## Cleaning History & Maps\n\n```bash\n# Recent cleaning sessions\nbash scripts/roomba-ctl.sh history\nbash scripts/roomba-ctl.sh history --limit 20\n\n# Detailed session report\nbash scripts/roomba-ctl.sh history <session_id>\n\n# Cleaning statistics\nbash scripts/roomba-ctl.sh stats\n# Output: This week: 4 cleans, 3.2 hrs, 1,240 sq ft avg\n#         This month: 14 cleans, 11.8 hrs, 1,180 sq ft avg\n#         Lifetime: 342 cleans, 298.5 hrs\n\n# Export history as CSV\nbash scripts/roomba-ctl.sh history export cleaning_log.csv --days 90\n\n# Coverage map (ASCII visualization)\nbash scripts/roomba-ctl.sh map\n```\n\n---\n\n## Multi-Robot Support\n\n```bash\n# List all robots\nbash scripts/roomba-ctl.sh robots\n\n# Switch default robot\nbash scripts/roomba-ctl.sh use \"Dusty\"\n\n# Command a specific robot\nbash scripts/roomba-ctl.sh --robot \"Dusty\" clean\n\n# Start all robots\nbash scripts/roomba-ctl.sh clean --all\n\n# Status of all robots\nbash scripts/roomba-ctl.sh status --all\n```\n\n---\n\n## Scripting & Automation\n\n**Clean before guests arrive (cron):**\n```bash\n# Friday at 4 PM — clean living areas\n0 16 * * 5 bash /path/to/roomba-ctl.sh clean --rooms \"Living Room,Dining Room,Kitchen\"\n```\n\n**Post-clean notification:**\n```bash\nbash scripts/roomba-ctl.sh clean\nwhile bash scripts/roomba-ctl.sh status --raw | grep -q \"running\"; do sleep 60; done\necho \"Cleaning complete!\" | mail -s \"Roomba Done\" you@email.com\n```\n\n**Consumable shopping reminder:**\n```bash\nLOW=$(bash scripts/roomba-ctl.sh consumables --alert 25 --names)\nif [ -n \"$LOW\" ]; then\n  echo \"Time to order: $LOW\" | mail -s \"Roomba Parts Needed\" you@email.com\nfi\n```\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n| Command | Description |\n|---------|-------------|\n| `setup` | Configuration instructions |\n| `status` | Full robot status + consumables |\n| `clean` | Clean |\n| `dock` | Send to charging dock |\n| `pause` | Pause |\n| `resume` | Resume |\n| `schedule` | Schedule |\n| `history` | View cleaning history |\n\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\nRun `roomba-control help` to see all available commands.\n\nFile v2.3.2:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"roomba-control\",\n  \"version\": \"2.3.2\",\n  \"publishedAt\": 1773611711789\n}\n\nFile v2.3.2:tips.md\n\n# Tips for Roomba Control\n\n## Getting Better Cleans\n\n1. **Schedule during quiet hours.** The Roomba works best when the house is empty — no feet, pets, or toys to dodge.\n\n2. **Use room-specific cleaning** on supported models (i/j/s series). Targeted runs are faster and more efficient than full-house cleans.\n\n3. **Empty the bin before each clean** (or rely on the auto-empty base if you have one). A full bin significantly reduces suction power.\n\n4. **Check consumables monthly.** The `consumables` command shows remaining life. Replace filters and brushes before they're completely worn to maintain cleaning performance.\n\n5. **Run `stats`** weekly to track cleaning efficiency. Declining coverage area might mean the robot needs maintenance.\n\n## Multi-Room Strategy\n\n- Clean high-traffic areas (kitchen, hallways) daily\n- Clean bedrooms and offices 2-3x per week\n- Do a full-house clean once a week\n- Use `--rooms` to target specific areas per schedule\n\n## Consumable Replacement Schedule\n\n| Part | Typical Lifespan | Signs of Wear |\n|------|------------------|---------------|\n| Filter | 2 months | Visible debris, reduced suction |\n| Side Brush | 2-3 months | Bent/worn bristles |\n| Main Brush | 6-8 months | Frayed bristles, reduced pickup |\n| Dust Bag | 30 days (auto-empty) | Base indicates full |\n\n## Troubleshooting\n\n- **\"Roomba stuck\"** — Check for tangled hair on brushes, stuck wheels, or obstacles. Clear and restart.\n- **\"Charging error\"** — Clean the charging contacts on both the robot and dock with a dry cloth.\n- **Room names not matching** — Names must match exactly what's in the iRobot app, including capitalization.\n- **Wi-Fi disconnects** — Keep the dock within good Wi-Fi range. Consider a Wi-Fi extender if your Pi is far from the router.\n\n## Automation Recipes\n\n- Clean the kitchen 30 minutes after dinner (tie to a calendar event or manual trigger)\n- Run a deep clean before weekly house guests\n- Alert when bin is full so you can empty it before the next scheduled clean\n- Pair with `homeassistant-toolkit` for trigger-based cleaning (e.g., everyone leaves the house)\n\nArchive v2.3.1: 4 files, 7404 bytes\n\nFiles: scripts/roomba.sh (9773b), SKILL.md (6098b), tips.md (2106b), _meta.json (133b)\n\nFile v2.3.1:SKILL.md\n\n---\nname: roomba-control\ndescription: \"Manage iRobot Roomba vacuums via the cloud API. Start/stop/schedule cleaning jobs, monitor consumable status, and view cleaning maps and history. Use when you need roomba control capabilities. Triggers on: roomba control.\"\n---\n\n# Roomba Control\n\nCommand your iRobot Roomba from the terminal.\n\n---\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [Configuration](#configuration)\n- [Core Commands](#core-commands)\n- [Cleaning Jobs](#cleaning-jobs)\n- [Scheduling](#scheduling)\n- [Consumable Tracking](#consumable-tracking)\n- [Cleaning History & Maps](#cleaning-history--maps)\n- [Multi-Robot Support](#multi-robot-support)\n- [Scripting & Automation](#scripting--automation)\n\n---\n\n## Requirements\n\n- An iRobot Roomba with Wi-Fi connectivity (600/700/800/900/i/j/s series)\n- iRobot account credentials\n- Python 3.6+\n- Network access to iRobot cloud services\n\n## Configuration\n\n```bash\nexport IROBOT_EMAIL=\"you@example.com\"\nexport IROBOT_PASSWORD=\"your-password\"\n```\n\nFirst-time setup discovers your robots:\n\n```bash\n$ bash scripts/roomba-ctl.sh setup\n\nDiscovering robots on your account...\nFound 2 robots:\n  [1] Rosie       — Roomba j7+    (Online, Docked)\n  [2] Dusty       — Roomba i3     (Online, Docked)\n\nConfiguration saved to ~/.roomba-control/config.json\nDefault robot set to: Rosie\n```\n\n---\n\n## Core Commands\n\n```bash\n# Robot status\nbash scripts/roomba-ctl.sh status\n# Output: Rosie (j7+) | Docked | Battery: 94% | Last clean: 2h ago | Bin: OK\n\n# Detailed info\nbash scripts/roomba-ctl.sh info\n\n# Network/connectivity check\nbash scripts/roomba-ctl.sh ping\n\n# Identify robot (plays a sound)\nbash scripts/roomba-ctl.sh find\n```\n\n---\n\n## Cleaning Jobs\n\n### Start & Stop\n\n```bash\n# Start cleaning (full house)\nbash scripts/roomba-ctl.sh clean\n\n# Clean specific rooms (requires room-mapping capable models)\nbash scripts/roomba-ctl.sh clean --rooms \"Kitchen,Living Room\"\n\n# Pause current job\nbash scripts/roomba-ctl.sh pause\n\n# Resume paused job\nbash scripts/roomba-ctl.sh resume\n\n# Send back to dock\nbash scripts/roomba-ctl.sh dock\n\n# Emergency stop\nbash scripts/roomba-ctl.sh stop\n```\n\n### Job Monitoring\n\n```bash\n# Current job progress\nbash scripts/roomba-ctl.sh progress\n# Output: Cleaning... 65% complete | 23 min elapsed | Kitchen ✓ | Living Room (in progress)\n\n# Follow job in real-time (updates every 30s)\nbash scripts/roomba-ctl.sh progress --follow\n```\n\n---\n\n## Scheduling\n\n```bash\n# View current schedule\nbash scripts/roomba-ctl.sh schedule\n\n# Set daily schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00\n\n# Set weekday-only schedule\nbash scripts/roomba-ctl.sh schedule set --weekdays 10:00\n\n# Custom schedule\nbash scripts/roomba-ctl.sh schedule set --days mon,wed,fri --time 14:00\n\n# Specific rooms on schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00 --rooms \"Kitchen,Hallway\"\n\n# Disable schedule\nbash scripts/roomba-ctl.sh schedule off\n\n# Enable schedule\nbash scripts/roomba-ctl.sh schedule on\n```\n\n---\n\n## Consumable Tracking\n\nKeep tabs on parts that need replacement.\n\n```bash\n$ bash scripts/roomba-ctl.sh consumables\n\nConsumable Status — Rosie (j7+)\n────────────────────────────────────\nMain Brush:     ████████░░ 78%   (~44 hours remaining)\nSide Brush:     █████░░░░░ 52%   (~26 hours remaining)\nFilter:         ███░░░░░░░ 31%   (~15 hours remaining)  ⚠️ Replace soon\nBin:            Full — Empty before next clean\nDust Bag:       ███████░░░ 68%   (auto-empty base)\n\nEstimated based on 6.2 hrs/week average usage.\n```\n\n```bash\n# Alert if any consumable below threshold\nbash scripts/roomba-ctl.sh consumables --alert 20\n# Exit code 1 if any below 20%\n\n# Reset consumable counter after replacement\nbash scripts/roomba-ctl.sh consumables reset filter\nbash scripts/roomba-ctl.sh consumables reset main_brush\n```\n\n---\n\n## Cleaning History & Maps\n\n```bash\n# Recent cleaning sessions\nbash scripts/roomba-ctl.sh history\nbash scripts/roomba-ctl.sh history --limit 20\n\n# Detailed session report\nbash scripts/roomba-ctl.sh history <session_id>\n\n# Cleaning statistics\nbash scripts/roomba-ctl.sh stats\n# Output: This week: 4 cleans, 3.2 hrs, 1,240 sq ft avg\n#         This month: 14 cleans, 11.8 hrs, 1,180 sq ft avg\n#         Lifetime: 342 cleans, 298.5 hrs\n\n# Export history as CSV\nbash scripts/roomba-ctl.sh history export cleaning_log.csv --days 90\n\n# Coverage map (ASCII visualization)\nbash scripts/roomba-ctl.sh map\n```\n\n---\n\n## Multi-Robot Support\n\n```bash\n# List all robots\nbash scripts/roomba-ctl.sh robots\n\n# Switch default robot\nbash scripts/roomba-ctl.sh use \"Dusty\"\n\n# Command a specific robot\nbash scripts/roomba-ctl.sh --robot \"Dusty\" clean\n\n# Start all robots\nbash scripts/roomba-ctl.sh clean --all\n\n# Status of all robots\nbash scripts/roomba-ctl.sh status --all\n```\n\n---\n\n## Scripting & Automation\n\n**Clean before guests arrive (cron):**\n```bash\n# Friday at 4 PM — clean living areas\n0 16 * * 5 bash /path/to/roomba-ctl.sh clean --rooms \"Living Room,Dining Room,Kitchen\"\n```\n\n**Post-clean notification:**\n```bash\nbash scripts/roomba-ctl.sh clean\nwhile bash scripts/roomba-ctl.sh status --raw | grep -q \"running\"; do sleep 60; done\necho \"Cleaning complete!\" | mail -s \"Roomba Done\" you@email.com\n```\n\n**Consumable shopping reminder:**\n```bash\nLOW=$(bash scripts/roomba-ctl.sh consumables --alert 25 --names)\nif [ -n \"$LOW\" ]; then\n  echo \"Time to order: $LOW\" | mail -s \"Roomba Parts Needed\" you@email.com\nfi\n```\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n| Command | Description |\n|---------|-------------|\n| `setup` | Configuration instructions |\n| `status` | Full robot status + consumables |\n| `clean` | Clean |\n| `dock` | Send to charging dock |\n| `pause` | Pause |\n| `resume` | Resume |\n| `schedule` | Schedule |\n| `history` | View cleaning history |\n\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\n## Commands\n\nRun `roomba-control help` to see all available commands.\n\nFile v2.3.1:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"roomba-control\",\n  \"version\": \"2.3.1\",\n  \"publishedAt\": 1773539210719\n}\n\nFile v2.3.1:tips.md\n\n# Tips for Roomba Control\n\n## Getting Better Cleans\n\n1. **Schedule during quiet hours.** The Roomba works best when the house is empty — no feet, pets, or toys to dodge.\n\n2. **Use room-specific cleaning** on supported models (i/j/s series). Targeted runs are faster and more efficient than full-house cleans.\n\n3. **Empty the bin before each clean** (or rely on the auto-empty base if you have one). A full bin significantly reduces suction power.\n\n4. **Check consumables monthly.** The `consumables` command shows remaining life. Replace filters and brushes before they're completely worn to maintain cleaning performance.\n\n5. **Run `stats`** weekly to track cleaning efficiency. Declining coverage area might mean the robot needs maintenance.\n\n## Multi-Room Strategy\n\n- Clean high-traffic areas (kitchen, hallways) daily\n- Clean bedrooms and offices 2-3x per week\n- Do a full-house clean once a week\n- Use `--rooms` to target specific areas per schedule\n\n## Consumable Replacement Schedule\n\n| Part | Typical Lifespan | Signs of Wear |\n|------|------------------|---------------|\n| Filter | 2 months | Visible debris, reduced suction |\n| Side Brush | 2-3 months | Bent/worn bristles |\n| Main Brush | 6-8 months | Frayed bristles, reduced pickup |\n| Dust Bag | 30 days (auto-empty) | Base indicates full |\n\n## Troubleshooting\n\n- **\"Roomba stuck\"** — Check for tangled hair on brushes, stuck wheels, or obstacles. Clear and restart.\n- **\"Charging error\"** — Clean the charging contacts on both the robot and dock with a dry cloth.\n- **Room names not matching** — Names must match exactly what's in the iRobot app, including capitalization.\n- **Wi-Fi disconnects** — Keep the dock within good Wi-Fi range. Consider a Wi-Fi extender if your Pi is far from the router.\n\n## Automation Recipes\n\n- Clean the kitchen 30 minutes after dinner (tie to a calendar event or manual trigger)\n- Run a deep clean before weekly house guests\n- Alert when bin is full so you can empty it before the next scheduled clean\n- Pair with `homeassistant-toolkit` for trigger-based cleaning (e.g., everyone leaves the house)\n\nArchive v2.3.0: 4 files, 7372 bytes\n\nFiles: scripts/roomba.sh (9773b), SKILL.md (6027b), tips.md (2106b), _meta.json (133b)\n\nFile v2.3.0:SKILL.md\n\n---\nname: roomba-control\ndescription: \"Manage iRobot Roomba vacuums via the cloud API. Start/stop/schedule cleaning jobs, monitor consumable status, and view cleaning maps and history. Use when you need roomba control capabilities. Triggers on: roomba control.\"\n---\n\n# Roomba Control\n\nCommand your iRobot Roomba from the terminal.\n\n---\n\n## Table of Contents\n\n- [Requirements](#requirements)\n- [Configuration](#configuration)\n- [Core Commands](#core-commands)\n- [Cleaning Jobs](#cleaning-jobs)\n- [Scheduling](#scheduling)\n- [Consumable Tracking](#consumable-tracking)\n- [Cleaning History & Maps](#cleaning-history--maps)\n- [Multi-Robot Support](#multi-robot-support)\n- [Scripting & Automation](#scripting--automation)\n\n---\n\n## Requirements\n\n- An iRobot Roomba with Wi-Fi connectivity (600/700/800/900/i/j/s series)\n- iRobot account credentials\n- Python 3.6+\n- Network access to iRobot cloud services\n\n## Configuration\n\n```bash\nexport IROBOT_EMAIL=\"you@example.com\"\nexport IROBOT_PASSWORD=\"your-password\"\n```\n\nFirst-time setup discovers your robots:\n\n```bash\n$ bash scripts/roomba-ctl.sh setup\n\nDiscovering robots on your account...\nFound 2 robots:\n  [1] Rosie       — Roomba j7+    (Online, Docked)\n  [2] Dusty       — Roomba i3     (Online, Docked)\n\nConfiguration saved to ~/.roomba-control/config.json\nDefault robot set to: Rosie\n```\n\n---\n\n## Core Commands\n\n```bash\n# Robot status\nbash scripts/roomba-ctl.sh status\n# Output: Rosie (j7+) | Docked | Battery: 94% | Last clean: 2h ago | Bin: OK\n\n# Detailed info\nbash scripts/roomba-ctl.sh info\n\n# Network/connectivity check\nbash scripts/roomba-ctl.sh ping\n\n# Identify robot (plays a sound)\nbash scripts/roomba-ctl.sh find\n```\n\n---\n\n## Cleaning Jobs\n\n### Start & Stop\n\n```bash\n# Start cleaning (full house)\nbash scripts/roomba-ctl.sh clean\n\n# Clean specific rooms (requires room-mapping capable models)\nbash scripts/roomba-ctl.sh clean --rooms \"Kitchen,Living Room\"\n\n# Pause current job\nbash scripts/roomba-ctl.sh pause\n\n# Resume paused job\nbash scripts/roomba-ctl.sh resume\n\n# Send back to dock\nbash scripts/roomba-ctl.sh dock\n\n# Emergency stop\nbash scripts/roomba-ctl.sh stop\n```\n\n### Job Monitoring\n\n```bash\n# Current job progress\nbash scripts/roomba-ctl.sh progress\n# Output: Cleaning... 65% complete | 23 min elapsed | Kitchen ✓ | Living Room (in progress)\n\n# Follow job in real-time (updates every 30s)\nbash scripts/roomba-ctl.sh progress --follow\n```\n\n---\n\n## Scheduling\n\n```bash\n# View current schedule\nbash scripts/roomba-ctl.sh schedule\n\n# Set daily schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00\n\n# Set weekday-only schedule\nbash scripts/roomba-ctl.sh schedule set --weekdays 10:00\n\n# Custom schedule\nbash scripts/roomba-ctl.sh schedule set --days mon,wed,fri --time 14:00\n\n# Specific rooms on schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00 --rooms \"Kitchen,Hallway\"\n\n# Disable schedule\nbash scripts/roomba-ctl.sh schedule off\n\n# Enable schedule\nbash scripts/roomba-ctl.sh schedule on\n```\n\n---\n\n## Consumable Tracking\n\nKeep tabs on parts that need replacement.\n\n```bash\n$ bash scripts/roomba-ctl.sh consumables\n\nConsumable Status — Rosie (j7+)\n────────────────────────────────────\nMain Brush:     ████████░░ 78%   (~44 hours remaining)\nSide Brush:     █████░░░░░ 52%   (~26 hours remaining)\nFilter:         ███░░░░░░░ 31%   (~15 hours remaining)  ⚠️ Replace soon\nBin:            Full — Empty before next clean\nDust Bag:       ███████░░░ 68%   (auto-empty base)\n\nEstimated based on 6.2 hrs/week average usage.\n```\n\n```bash\n# Alert if any consumable below threshold\nbash scripts/roomba-ctl.sh consumables --alert 20\n# Exit code 1 if any below 20%\n\n# Reset consumable counter after replacement\nbash scripts/roomba-ctl.sh consumables reset filter\nbash scripts/roomba-ctl.sh consumables reset main_brush\n```\n\n---\n\n## Cleaning History & Maps\n\n```bash\n# Recent cleaning sessions\nbash scripts/roomba-ctl.sh history\nbash scripts/roomba-ctl.sh history --limit 20\n\n# Detailed session report\nbash scripts/roomba-ctl.sh history <session_id>\n\n# Cleaning statistics\nbash scripts/roomba-ctl.sh stats\n# Output: This week: 4 cleans, 3.2 hrs, 1,240 sq ft avg\n#         This month: 14 cleans, 11.8 hrs, 1,180 sq ft avg\n#         Lifetime: 342 cleans, 298.5 hrs\n\n# Export history as CSV\nbash scripts/roomba-ctl.sh history export cleaning_log.csv --days 90\n\n# Coverage map (ASCII visualization)\nbash scripts/roomba-ctl.sh map\n```\n\n---\n\n## Multi-Robot Support\n\n```bash\n# List all robots\nbash scripts/roomba-ctl.sh robots\n\n# Switch default robot\nbash scripts/roomba-ctl.sh use \"Dusty\"\n\n# Command a specific robot\nbash scripts/roomba-ctl.sh --robot \"Dusty\" clean\n\n# Start all robots\nbash scripts/roomba-ctl.sh clean --all\n\n# Status of all robots\nbash scripts/roomba-ctl.sh status --all\n```\n\n---\n\n## Scripting & Automation\n\n**Clean before guests arrive (cron):**\n```bash\n# Friday at 4 PM — clean living areas\n0 16 * * 5 bash /path/to/roomba-ctl.sh clean --rooms \"Living Room,Dining Room,Kitchen\"\n```\n\n**Post-clean notification:**\n```bash\nbash scripts/roomba-ctl.sh clean\nwhile bash scripts/roomba-ctl.sh status --raw | grep -q \"running\"; do sleep 60; done\necho \"Cleaning complete!\" | mail -s \"Roomba Done\" you@email.com\n```\n\n**Consumable shopping reminder:**\n```bash\nLOW=$(bash scripts/roomba-ctl.sh consumables --alert 25 --names)\nif [ -n \"$LOW\" ]; then\n  echo \"Time to order: $LOW\" | mail -s \"Roomba Parts Needed\" you@email.com\nfi\n```\n\n---\n\n## Troubleshooting\n\n| Issue | Solution |\n| Command | Description |\n|---------|-------------|\n| `setup` | Configuration instructions |\n| `status` | Full robot status + consumables |\n| `clean` | Clean |\n| `dock` | Send to charging dock |\n| `pause` | Pause |\n| `resume` | Resume |\n| `schedule` | Schedule |\n| `history` | View cleaning history |\n\n---\n💬 Feedback & Feature Requests: https://bytesagain.com/feedback\nPowered by BytesAgain | bytesagain.com\n\nFile v2.3.0:_meta.json\n\n{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"roomba-control\",\n  \"version\": \"2.3.0\",\n  \"publishedAt\": 1773447673894\n}\n\nFile v2.3.0:tips.md\n\n# Tips for Roomba Control\n\n## Getting Better Cleans\n\n1. **Schedule during quiet hours.** The Roomba works best when the house is empty — no feet, pets, or toys to dodge.\n\n2. **Use room-specific cleaning** on supported models (i/j/s series). Targeted runs are faster and more efficient than full-house cleans.\n\n3. **Empty the bin before each clean** (or rely on the auto-empty base if you have one). A full bin significantly reduces suction power.\n\n4. **Check consumables monthly.** The `consumables` command shows remaining life. Replace filters and brushes before they're completely worn to maintain cleaning performance.\n\n5. **Run `stats`** weekly to track cleaning efficiency. Declining coverage area might mean the robot needs maintenance.\n\n## Multi-Room Strategy\n\n- Clean high-traffic areas (kitchen, hallways) daily\n- Clean bedrooms and offices 2-3x per week\n- Do a full-house clean once a week\n- Use `--rooms` to target specific areas per schedule\n\n## Consumable Replacement Schedule\n\n| Part | Typical Lifespan | Signs of Wear |\n|------|------------------|---------------|\n| Filter | 2 months | Visible debris, reduced suction |\n| Side Brush | 2-3 months | Bent/worn bristles |\n| Main Brush | 6-8 months | Frayed bristles, reduced pickup |\n| Dust Bag | 30 days (auto-empty) | Base indicates full |\n\n## Troubleshooting\n\n- **\"Roomba stuck\"** — Check for tangled hair on brushes, stuck wheels, or obstacles. Clear and restart.\n- **\"Charging error\"** — Clean the charging contacts on both the robot and dock with a dry cloth.\n- **Room names not matching** — Names must match exactly what's in the iRobot app, including capitalization.\n- **Wi-Fi disconnects** — Keep the dock within good Wi-Fi range. Consider a Wi-Fi extender if your Pi is far from the router.\n\n## Automation Recipes\n\n- Clean the kitchen 30 minutes after dinner (tie to a calendar event or manual trigger)\n- Run a deep clean before weekly house guests\n- Alert when bin is full so you can empty it before the next scheduled clean\n- Pair with `homeassistant-toolkit` for trigger-based cleaning (e.g., everyone leaves the house)","readmeExcerpt":"Skill: Roomba Control Owner: bytesagain-lab Summary: Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Roomba Control concepts, best practices, and implementation patterns. Tags: chinese:1.0.0, latest:3.0.1, productivity:1.0.0 Version history: v3.0.1 | 2026-03-24T01:44:26.264Z | user Fix description v3.0.0 | 2026-03-23T00:58:34.255Z | user Clean package v2.0.1 | 2026-03-18T10:49:","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"export IROBOT_EMAIL=\"you@example.com\"\nexport IROBOT_PASSWORD=\"your-password\""},{"language":"bash","snippet":"$ bash scripts/roomba-ctl.sh setup\n\nDiscovering robots on your account...\nFound 2 robots:\n  [1] Rosie       — Roomba j7+    (Online, Docked)\n  [2] Dusty       — Roomba i3     (Online, Docked)\n\nConfiguration saved to ~/.roomba-control/config.json\nDefault robot set to: Rosie"},{"language":"bash","snippet":"# Robot status\nbash scripts/roomba-ctl.sh status\n# Output: Rosie (j7+) | Docked | Battery: 94% | Last clean: 2h ago | Bin: OK\n\n# Detailed info\nbash scripts/roomba-ctl.sh info\n\n# Network/connectivity check\nbash scripts/roomba-ctl.sh ping\n\n# Identify robot (plays a sound)\nbash scripts/roomba-ctl.sh find"},{"language":"bash","snippet":"# Start cleaning (full house)\nbash scripts/roomba-ctl.sh clean\n\n# Clean specific rooms (requires room-mapping capable models)\nbash scripts/roomba-ctl.sh clean --rooms \"Kitchen,Living Room\"\n\n# Pause current job\nbash scripts/roomba-ctl.sh pause\n\n# Resume paused job\nbash scripts/roomba-ctl.sh resume\n\n# Send back to dock\nbash scripts/roomba-ctl.sh dock\n\n# Emergency stop\nbash scripts/roomba-ctl.sh stop"},{"language":"bash","snippet":"# Current job progress\nbash scripts/roomba-ctl.sh progress\n# Output: Cleaning... 65% complete | 23 min elapsed | Kitchen ✓ | Living Room (in progress)\n\n# Follow job in real-time (updates every 30s)\nbash scripts/roomba-ctl.sh progress --follow"},{"language":"bash","snippet":"# View current schedule\nbash scripts/roomba-ctl.sh schedule\n\n# Set daily schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00\n\n# Set weekday-only schedule\nbash scripts/roomba-ctl.sh schedule set --weekdays 10:00\n\n# Custom schedule\nbash scripts/roomba-ctl.sh schedule set --days mon,wed,fri --time 14:00\n\n# Specific rooms on schedule\nbash scripts/roomba-ctl.sh schedule set --daily 09:00 --rooms \"Kitchen,Hallway\"\n\n# Disable schedule\nbash scripts/roomba-ctl.sh schedule off\n\n# Enable schedule\nbash scripts/roomba-ctl.sh schedule on"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"roomba-control\"\nversion: \"3.0.1\"\ndescription: \"Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Roomba Control concepts, best practices, and implementation patterns.\"\nauthor: \"BytesAgain\"\nhomepage: \"https://bytesagain.com\"\nsource: \"https://github.com/bytesagain/ai-skills\"\ntags: [roomba,control, reference]\ncategory: \"life\"\n---\n\n# Roomba Control\n\nReference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Roomba Control concepts, best practices, and implementation patterns. No API keys or credentials required.\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `intro` | intro reference |\n| `quickstart` | quickstart reference |\n| `patterns` | patterns reference |\n| `debugging` | debugging reference |\n| `performance` | performance reference |\n| `security` | security reference |\n| `migration` | migration reference |\n| `cheatsheet` | cheatsheet reference |\n\n## Output Format\n\nAll commands output plain-text reference documentation via heredoc. No external API calls, no credentials needed, no network access.\n\n---\n\n*Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn76vqrf94wk924mddj8fp4p5x8497tb\",\n  \"slug\": \"roomba-control\",\n  \"version\": \"3.0.1\",\n  \"publishedAt\": 1774316666264\n}"},{"path":"skill-card.md","content":"## Description:\n\nReference tool for life - covers intro, quickstart, patterns and more. Quick lookup for Roomba Control concepts, best practices, and implementation patterns.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[bytesagain-lab](https://clawhub.ai/user/bytesagain-lab)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nDevelopers and external users use this skill for quick plain-text reference material about Roomba Control concepts, commands, troubleshooting, security, migration, and related patterns.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The server security guidance notes that the content appears generic despite being branded as Roomba Control.\n\nMitigation: Review the reference text for domain accuracy before relying on it or publishing it as product-specific guidance.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/bytesagain-lab/skills/roomba-control)\n- [BytesAgain homepage](https://bytesagain.com)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Shell commands, Guidance]\n\n**Output Format:** [Plain text and Markdown-style reference documentation emitted by shell commands]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Static command-specific reference output; evidence.security reports no credentials, network access, file access, or persistent system changes.]\n\n## Skill Version(s):\n\n3.0.1 (source: server release metadata and SKILL.md frontmatter)\n\n## Ethical Considerations:\n\nUsers should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment."}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Roomba Control concepts, best practices, and implementation patterns. Skill: Roomba Control Owner: bytesagain-lab Summary: Reference tool for life — covers intro, quickstart, patterns and more. Quick lookup for Roomba Control concepts, best practices, and implementation patterns. Tags: chinese:1.0.0, latest:3.0.1, productivity:1.0.0 Version history: v3.0.1 | 2026-03-24T01:44:26.264Z | user Fix description v3.0.0 | 2026-03-23T00:58:34.255Z | user Clean package v2.0.1 | 2026-03-18T10:49:","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":764,"uniquenessScore":53,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-10T22:16:16.496Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-10T22:16:16.496Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-11T00:31:04.927Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}