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

Ready to run

npx skills add https://github.com/buddyh/agent-skills --skill project-spawn

💬 Prompt for ChatGPT / Claude Chat▼

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.