pickup
Codex pickup checklist when starting on a task.
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.
| name | pickup |
|---|---|
| description | Codex pickup checklist when starting on a task. |
Pickup
Purpose: rehydrate context quickly when you start work.
Steps:
- Read AGENTS.MD pointer + relevant docs (run
./scripts/docs-list.tsif present). - Repo state:
git status -sb; check for local commits; confirm current branch/PR. - CI/PR:
gh pr view <num> --comments --files(or derive PR from branch) and note failing checks. - tmux/processes: list sessions and attach if needed:
tmux list-sessions- If sessions exist:
tmux attach -t codex-shellortmux capture-pane -p -J -t codex-shell:0.0 -S -200
- Tests/checks: note what last ran (from handoff notes/CI) and what you will run first.
- Changelog + docs: skim recent updates for context, but do not rely on them alone.
- 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.