skills.rest
buddyh
buddyhCOMMUNITY
Explore all skills by this author →
𝕏@buddyhadryGitHub

project-spawn

Spawn a Claude Code or Codex session in a project directory with a handoff document.

5|1|Updated Dec 22, 2025
Search Tags:#codex#tmux#handoff#session#claude-code#project#spawn
One-click install
npx skills add https://github.com/buddyh/agent-skills --skill project-spawn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: project-spawn
Source: https://github.com/buddyh/agent-skills/tree/main/project-spawn
Command: npx skills add https://github.com/buddyh/agent-skills --skill project-spawn

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Pivoting between projects can scatter context and waste time; project-spawn creates a dedicated session and a handoff document to preserve conversation history and start working in a focused directory.

Core Features & Use Cases

  • Create a new Claude Code or Codex session in a target project directory with a pre-populated handoff document (PROJECT_HANDOFF.md) that carries context from current conversation.
  • Resolve target project paths with explicit or relative inputs and automatically initialize or attach to a named tmux session for continued work.
  • Generate a handoff document and launch the session ready for immediate coding or research tasks in the targeted project.

Quick Start

Start a new Claude Code session for a project directory and hand off current context with PROJECT_HANDOFF.md.

Frequently Asked Questions about project-spawn

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

FAQPage Schema
How do I spawn a Claude Code session in a specific project directory with context?▼

To spawn a Claude Code session, provide an explicit or relative target project path. The tool creates a named tmux session and generates a PROJECT_HANDOFF.md file to carry relevant context into the new session.

What is a project handoff document and when do I need one for tmux sessions?▼

A project handoff document preserves conversation history when pivoting between projects. You need one when creating a dedicated tmux session to start working in a focused directory without losing prior context.

How do I start a Codex session with a pre-populated handoff document?▼

Start a Codex session by resolving the target project path and generating a PROJECT_HANDOFF.md file. The tool operates with provided scripts to launch Codex ready for immediate coding tasks in the target directory.

Can I attach to an existing tmux session instead of creating a new one?▼

Yes, the tool automatically initializes or attaches to a named tmux session for the specified project directory, ensuring continued work without spawning duplicate sessions.

Does project-spawn work with both Claude Code and Codex?▼

Yes, project-spawn supports launching both Claude Code and Codex sessions. It resolves the target project path, creates a tmux session, and generates a handoff document for either environment.

What's the best way to preserve conversation history when switching between projects?▼

The best way to preserve context is generating a PROJECT_HANDOFF.md document that carries relevant conversation history. This document is automatically created when spawning a focused session in the target directory.

Related Skills

Explore More Software Engineering Skills→
adoreseveradoresever
202

tmux

Send keystrokes and scrape pane output to automate tmux sessions.

Community
Advanced
vignesh2027vignesh2027
18

tmux

Manage and automate tmux session and pane operations.

Community
Intermediate
reidemeister94reidemeister94
10

handoff

Creates a portable session context document in the OS temp directory and prints its absolute path.

Community
Intermediate
DavidROliverBADavidROliverBA
49

/wipe

Clear the current AI session and generate a context handoff summary.

Community
Intermediate