reset
Scannednpx machina-cli add skill brsbl/ottonomous/reset --openclawReset workflow data. Selectively or fully clears the .otto/ directory.
Available Targets
| Target | Directory | Contents |
|---|---|---|
tasks | .otto/tasks/ | Task lists |
specs | .otto/specs/ | Specifications |
sessions | .otto/sessions/ | Browser sessions |
all | Above targets | Everything except docs (default) |
Usage Examples
/reset- Clear everything (prompts for confirmation)/reset tasks- Clear only task lists/reset specs tasks- Clear specs and tasks/reset sessions- Clear browser sessions only/reset all- Explicit full reset
Workflow
1. Check for .otto/
if [[ ! -d ".otto" ]]; then
echo "No .otto/ directory found. Nothing to reset."
exit 0
fi
If no .otto/ exists, report and stop.
2. Parse Arguments
Map targets to directories:
tasks -> .otto/tasks/
specs -> .otto/specs/
sessions -> .otto/sessions/
all -> tasks + specs + sessions (NOT docs)
If no arguments or all specified, target tasks, specs, and sessions. Docs are always preserved.
3. Kill Active Processes (if sessions targeted or all)
for pid_file in .otto/sessions/*/browser.pid .otto/otto/sessions/*/browser.pid; do
[ -f "$pid_file" ] && kill $(cat "$pid_file") 2>/dev/null || true
done
4. Preview Removal
Show what will be removed with sizes:
du -sh <target_dirs> 2>/dev/null
Display to user:
Will remove:
.otto/tasks/ (4K)
.otto/specs/ (8K)
5. Confirm
Use AskUserQuestion:
"This will delete the selected workflow data. Continue?" Options: "Yes, reset" / "Cancel"
6. Remove
After confirmation, remove only the targeted directories:
rm -rf <target_dirs>
For all, remove tasks, specs, and sessions (preserving docs):
rm -rf .otto/tasks .otto/specs .otto/sessions .otto/otto
7. Report
Reset complete. Cleared: tasks, specs
Run /otto or /spec to continue.
Overview
Resets remove workflow artifacts stored in the .otto/ directory: tasks, specs, and sessions. It is destructive and requires confirmation, while docs are preserved. Use this to start over with a clean slate when your workflow data has become cluttered or corrupted.
How This Skill Works
The tool checks for the .otto/ directory, maps the requested targets to their corresponding subdirectories, optionally kills active browser sessions, previews the removal with sizes, prompts for confirmation, and then deletes the selected directories. Docs remain untouched throughout the process.
When to Use It
- Starting fresh by clearing all workflow data, while docs stay intact.
- Clearing only task lists to remove outdated or completed tasks.
- Removing specs to discard obsolete specifications while preserving other data.
- Killing and clearing browser sessions to resolve session-related issues.
- Performing a full reset (all targets) to recover from a broken state, with docs preserved.
Quick Start
- Step 1: Decide the scope (tasks, specs, sessions, or all).
- Step 2: Run the reset command with your chosen targets, e.g., /reset specs.
- Step 3: Confirm the prompt to complete the removal.
Best Practices
- Always confirm destructive prompts before removal.
- Use specific targets (tasks, specs, sessions) to minimize data loss.
- Preview what will be removed and verify sizes before confirming.
- Ensure no critical processes are active or back up data if needed.
- Remember that docs are preserved regardless of the reset scope.
Example Use Cases
- Using /reset to clear everything except docs and start fresh.
- Running /reset tasks to purge only task lists.
- Executing /reset specs tasks to remove both specs and tasks.
- Targeting sessions with /reset sessions to clear browser sessions.
- Performing /reset all for a full clean slate (docs preserved).
