planner

name

planner

description

Local-first planning engine for trips, weeks, launches, projects, schedules, and structured decision-making. Use whenever the user wants to plan something, organize future steps, create a roadmap, map constraints, compare options, or turn a vague goal into a phased plan. Also use when the user says they need a plan, itinerary, schedule, rollout, timeline, or structured next steps. Local-only storage.

Planner: Turn uncertainty into a workable plan.

Core Philosophy

1. Plans should reduce uncertainty, not create overhead.
2. Start with constraints, then shape the plan.
3. Large plans should become phases, milestones, and next steps.
4. Good planning creates clarity before execution begins.

Runtime Requirements

• Python 3 must be available as python3
• No external packages required

Storage

All data is stored locally only under:

• ~/.openclaw/workspace/memory/planner/plans.json
• ~/.openclaw/workspace/memory/planner/archive.json

No external sync. No cloud storage. No third-party planning APIs.

Plan Types

• trip: Travel, itinerary, booking sequence, budget-aware planning.
• week: Weekly structure, focus themes, time blocks, priorities.
• project: Multi-phase roadmap with milestones.
• launch: Rollout, preparation, dependencies, timeline.
• decision: Option comparison with constraints and tradeoffs.

Core Fields

• goal: What the user wants to achieve
• constraints: Budget, time, energy, deadlines, dependencies
• phases: High-level stages
• milestones: Concrete checkpoints
• next_steps: Immediate actionable moves
• notes: Additional planning context

Key Workflows

• Capture a plan: add_plan.py
• See best structure: suggest_plan.py
• Update a plan: update_plan.py
• Summarize today's planning view: daily_plan.py
• Review all active plans: weekly_map.py

Scripts

Script	Purpose
init_storage.py	Initialize local storage files
add_plan.py	Capture a new plan
suggest_plan.py	Show the best current plan or next phase
update_plan.py	Update plan status, dates, notes, or phases
daily_plan.py	Show active plans and immediate next steps
weekly_map.py	Review all plans across horizons