pickup

Codex pickup checklist when starting on a task.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 2, 2026

When & Why to Use This Skill

The Codex Pickup skill is a specialized developer productivity tool designed to help users and AI agents quickly rehydrate context when starting or resuming a task. By automating a structured workflow—including repository state analysis, GitHub PR status checks, tmux session management, and test result verification—it ensures a seamless transition into coding, minimizes 'warm-up' time, and prevents context loss in complex software projects.

Use Cases

  • Task Resumption: Quickly regain focus after a break or weekend by automatically reviewing git status, local commits, and the current branch state.
  • Collaborative Handoff: Efficiently take over a task from another developer or agent by checking the latest PR comments, failing CI checks, and recent changelog updates.
  • Environment Synchronization: Instantly identify active background processes and tmux sessions to ensure the development environment is ready for execution.
  • Workflow Planning: Generate a concise 2–3 step action plan based on the current state of the codebase and CI/CD feedback.
namepickup
descriptionCodex pickup checklist when starting on a task.

Pickup

Purpose: rehydrate context quickly when you start work.

Steps:

  1. Read AGENTS.MD pointer + relevant docs (run ./scripts/docs-list.ts if present).
  2. Repo state: git status -sb; check for local commits; confirm current branch/PR.
  3. CI/PR: gh pr view <num> --comments --files (or derive PR from branch) and note failing checks.
  4. tmux/processes: list sessions and attach if needed:
    • tmux list-sessions
    • If sessions exist: tmux attach -t codex-shell or tmux capture-pane -p -J -t codex-shell:0.0 -S -200
  5. Tests/checks: note what last ran (from handoff notes/CI) and what you will run first.
  6. Changelog + docs: skim recent updates for context, but do not rely on them alone.
  7. Plan next 2–3 actions as bullets and execute.

Output format: concise bullet summary; include copy/paste tmux attach/capture commands when live sessions are present.