@stackwright-pro/raft

Launch the Pro Otter Raft — verifies otter integrity, writes init context, and spawns raft-puppy (or code-puppy) in foreman mode.

Prerequisites

Install the Stackwright-patched build of code-puppy:

pip install stackwright-puppy

This provides the raft-puppy binary (and code-puppy alias) with two fixes required for clean-install compatibility:

• MCP servers auto-enable on startup (no manual /mcp start needed)
• Local .code-puppy.json project config loading

Source: https://github.com/Per-Aspera-LLC/stackwright-puppy
Upstream: https://github.com/mpfaffenberger/code_puppy (MIT)

Usage

npx @stackwright-pro/raft [options]

Options

| Flag | Description | | ----------------------- | ------------------------------------- | | --project-root <path> | Project root directory (default: cwd) | | --verbose | Enable verbose logging | | --help, -h | Show help |

Binary resolution

raft searches for the Python binary in this order:

1. STACKWRIGHT_CODE_PUPPY_PATH env var (explicit override)
2. raft-puppy on PATH (stackwright-puppy fork — preferred)
3. code-puppy on PATH (vanilla upstream — fallback)

If neither is found, the error message will guide you to install stackwright-puppy.

What it does

1. Acquires a pipeline lock (.stackwright/.lock) to prevent concurrent sessions
2. Writes/enriches .stackwright/init-context.json (project name, spec path, theme)
3. Registers the @stackwright-pro/mcp server in ~/.code_puppy/mcp_servers.json
4. Verifies otter file integrity
5. Spawns raft-puppy / code-puppy in foreman mode with STACKWRIGHT_PROJECT_ROOT set

Version

See CHANGELOG.md for release history.