octo-patch

Patch Claude Octo plugin timeouts and Gemini provider behavior in cached plugin directories.

8|1|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/JoeCP17/LLM-Dot-files --skill octo-patch
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: octo-patch
Source: https://github.com/JoeCP17/LLM-Dot-files/tree/main/codex/skills/octo-patch
Command: npx skills add https://github.com/JoeCP17/LLM-Dot-files --skill octo-patch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents Claude Octo plugin timeouts and restores predictable Gemini-provider behavior by applying configuration overrides directly to Octo’s cached plugin code.

Core Features & Use Cases

  • Timeout override: Replaces hard-coded polling and agent timeout values with environment-variable defaults for more reliable long-running operations.
  • Gemini gating: Allows disabling Gemini detection via an environment variable to match your desired provider behavior.
  • Operational safety: Applies patches idempotently with .orig backups, verifies expected strings after patching, and reverts automatically if verification fails.

Quick Start

Ask to reapply the patch by telling the assistant: /octo-patch.

Frequently Asked Questions about octo-patch

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

FAQPage Schema
How do I fix Claude Octo plugin polling timeouts during long-running operations?

Fix Claude Octo polling timeouts by patching hard-coded timeout values in the local cached plugin directory with environment-variable-controlled defaults, ensuring reliable long-running operations without manual code edits.

Can I disable Gemini provider detection in the Octo plugin?

Yes, you can disable Gemini provider detection in Octo by applying a targeted string replacement gated by an OCTOPUS_* environment variable, overriding default provider behavior directly in the cached plugin code.

What is the safest way to apply configuration overrides to cached plugin code?

The safest way to apply configuration overrides to cached plugin code is an idempotent patching process that creates .orig backups, verifies expected string replacements succeed, and automatically reverts changes upon verification failure.

How do I apply patches to the latest Octo plugin version directory?

Apply patches to the latest Octo plugin version directory by triggering the patch process, which automatically detects the newest version folder, verifies target files exist, and executes targeted string replacements using OCTOPUS_* environment variables.

Why do Octo operations fail due to polling timeouts and how can I prevent it?

Octo operations fail due to polling timeouts when hard-coded limits in the cached plugin code are exceeded, which you can prevent by patching those values with environment-variable defaults for more reliable long-running execution.

Are Octo cached plugin patches reversible if the string replacement fails?

Yes, Octo cached plugin patches are reversible because the process creates idempotent .orig backups before applying targeted string replacements and automatically reverts to the original files if post-patch verification fails.