optimus-resume

Reattach to an in-progress task worktree and report live status.

Updated Apr 2, 2026

Search Tags:#workflow #worktree #resume #task #state.json #optimus

Ready to run

npx skills add https://github.com/alexgarzao/optimus --skill optimus-resume

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: optimus-resume
Source: https://github.com/alexgarzao/optimus/tree/main/resume/skills/optimus-resume
Command: npx skills add https://github.com/alexgarzao/optimus --skill optimus-resume

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Resuming work after a terminal is closed or session interrupted, locating the correct task workspace, reporting live status, and offering to proceed to the next stage without unintended state changes.

Core Features & Use Cases

Locate and reattach to an in-progress task by resolving the appropriate worktree and task metadata.
Read current status, branch, and pending actions, then present safe next-step options without mutating state unless the user explicitly chooses a reset flow.
Handle edge cases such as missing worktrees or inconsistent state by auto-recovering or guiding recovery steps with explicit user confirmation.

Quick Start

Run /optimus-resume to reattach to an in-progress task and continue to the recommended next step.

Frequently Asked Questions about optimus-resume

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

FAQPage Schema

How do I resume a task in a worktree after accidentally closing the terminal?▼

You can resume work after terminal closure by running the resume command to automatically locate the task worktree, validate state.json, and present safe next-step options without unintended state changes.

What happens if my task worktree is missing or has an inconsistent state.json when I try to resume?▼

If the worktree is missing or state.json is inconsistent, the resume process auto-recovers or guides you through explicit recovery steps with user confirmation to restore task state and branch readiness.

Can I pick up multiple administrative workflows where I left off across different tasks?▼

Yes, you can pick up multiple administrative workflows where you left off by locating the correct task worktree and reading current status and pending actions to safely continue each task.

Does resuming a task mutate the state.json file automatically?▼

No, resuming a task does not mutate state.json automatically. It reads current status and presents safe next-step options, only changing state if you explicitly choose a reset flow.

What is the best way to reattach to an in-progress task and continue to the recommended next step?▼

The best way to reattach to an in-progress task is to run the resume command, which validates task existence and branch readiness, then offers to proceed to the recommended next stage without unintended state changes.