pipit

Pipe any context into Claude Code sessions.

Screenshots, meeting notes, URLs, clipboard text -- capture it in one command, and Claude Code extracts tasks, plans implementation, and gets to work.

pipit go notes.md my-project

That's it. pipit opens a new terminal tab, feeds your context to Claude Code with a carefully crafted prompt, and Claude handles the rest -- extracting action items, planning, and implementing.

Install

npm install -g pipit-cli

Requires Node.js 20+ and Claude Code installed.

Usage

pipit go -- send context to Claude Code

# File (text, markdown, transcript)
pipit go meeting-notes.md my-project

# Screenshot or image
pipit go screenshot.png my-project

# URL
pipit go https://example.com/spec my-project

# Stdin
cat notes.txt | pipit go - my-project

pipit infers the input type automatically. Override with --input-type if needed.

Options

pipit go <input> <project-name> [options]

Options:
  -p, --project-dir <dir>     Project directory (repeatable)
  --input-type <type>         Override input type: file, image, url, stdin
  --control-level <level>     auto (default), plan_first, extract_only
  --mode <mode>               fire_and_forget (default), interactive
  --terminal <name>           ghostty, iterm2, warp, terminal
  --context <text>            Additional instructions for Claude
  --dry-run                   Print the prompt without launching
  --json                      Machine-readable JSON output

Control levels

• auto -- Claude gets full autonomy (--dangerously-skip-permissions). Context goes in, code comes out.
• plan_first -- Claude extracts and plans, then pauses for your approval before implementing.
• extract_only -- Just show the extracted tasks. You decide what to do next.

Session modes

• fire_and_forget -- Claude works autonomously. You watch and intervene if needed.
• interactive -- Claude interviews you first, then plans and implements collaboratively.

How it works

Your context (file, image, URL, clipboard)
    |
    v
pipit CLI (builds prompt, resolves input)
    |
    v
Terminal tab (Ghostty, iTerm2, Warp, Terminal.app)
    |
    v
Claude Code (extracts tasks, plans, implements, commits)
    |
    v
Results (branches, commits, PRs)

pipit doesn't preprocess your input or run a separate extraction pipeline. It builds a prompt and hands everything to Claude Code in an interactive terminal session. Claude is smart enough to handle raw context directly.

Terminal support

pipit opens Claude Code sessions in new terminal tabs via AppleScript:

• Ghostty (default) -- native API
• iTerm2 -- AppleScript integration
• Warp -- AppleScript integration
• Terminal.app -- always available as fallback

Set the default with --terminal or the PIPIT_TERMINAL environment variable.

Mac app

pipit also has a native macOS menu bar app that provides:

• Global hotkey to capture clipboard and launch a session
• File watchers for screenshots and transcripts
• Project management with multi-directory support
• One-click CLI installation

The Mac app calls the CLI under the hood -- all the logic lives here.

Requirements

• Node.js 20+
• Claude Code CLI installed and authenticated
• macOS (terminal automation uses AppleScript)

License

MIT