jedarden/claude-print
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Drop-in replacement for claude -p that drives the interactive TUI via PTY, preserving subscription billing
70 commits 1 branch 0 tags 100 MiB
Rust 98.8%
Shell 1.2%
Find a file
jedarden e16680820e Add bf-168 notes: claude-print-ci WorkflowTemplate added to declarative-config 
WorkflowTemplate claude-print-ci committed to jedarden/declarative-config at
k8s/iad-ci/argo-workflows/claude-print-ci-workflowtemplate.yml. Phase 9 scope:
verify step only, delegating to rust-verify. Build+release steps deferred to Phase 11.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-10 01:53:23 -04:00
.beads Close bead bf-3n3: claude-print.yaml NEEDLE adapter complete 2026-06-10 01:52:15 -04:00
docs gap-review round 10: 3 gaps fixed 2026-06-07 14:24:50 -04:00
notes Add bf-168 notes: claude-print-ci WorkflowTemplate added to declarative-config 2026-06-10 01:53:23 -04:00
src Add Phase 9: NEEDLE integration — install.sh, claude-print.yaml, --check subcommand 2026-06-10 01:36:28 -04:00
test-fixtures/mock-claude Add Phase 9: NEEDLE integration — install.sh, claude-print.yaml, --check subcommand 2026-06-10 01:36:28 -04:00
tests Add Phase 9: NEEDLE integration — install.sh, claude-print.yaml, --check subcommand 2026-06-10 01:36:28 -04:00
Cargo.lock Add mock-claude fixture, test_pty_spawns_tty integration test, and hook module export 2026-06-08 08:56:36 -04:00
Cargo.toml Phase 2: implement PTY open and fork in pty.rs 2026-06-07 16:38:14 -04:00
claude-print.yaml Add Phase 9: NEEDLE integration — install.sh, claude-print.yaml, --check subcommand 2026-06-10 01:36:28 -04:00
install.sh Add Phase 9: NEEDLE integration — install.sh, claude-print.yaml, --check subcommand 2026-06-10 01:36:28 -04:00
README.md Add Phase 9: NEEDLE integration — install.sh, claude-print.yaml, --check subcommand 2026-06-10 01:36:28 -04:00

README.md

claude-print

Drop-in replacement for claude -p (print/headless mode) that drives the Claude Code interactive TUI via PTY — preserving subscription billing after the June 15, 2026 Agent SDK credit split.

Why this exists

Starting June 15, 2026, Anthropic separates claude -p (headless) into a separate Agent SDK credit pool ($100–$200/month on Max plans). Only the interactive TUI (cc_entrypoint=cli) continues drawing from the unlimited subscription. claude-print wraps the interactive TUI in a PTY so callers get claude -p wire-compatible output while billing against the subscription.

Install

sh install.sh

Or set SKIP_MOCK_CLAUDE=1 to skip the mock_claude test fixture.

Usage

claude-print [OPTIONS] [PROMPT]

Reads prompt from positional argument, --input-file, or stdin (when not a TTY).

Flags

Flag Short Default Description
[PROMPT] Prompt string (mutually exclusive with --input-file and stdin)
--input-file <FILE> -f Read prompt from file
--model <MODEL> -m claude-sonnet-4-6 Model to use
--max-turns <N> 30 Maximum number of turns
--output-format <FORMAT> -o text Output format: text, json, stream-json
--allowedTools <LIST> Comma-separated list of allowed tools
--disallowedTools <LIST> Comma-separated list of disallowed tools
--dangerously-skip-permissions Skip permission prompts (dangerous)
--timeout <SECS> 3600 Wall-clock timeout in seconds
--claude-binary <PATH> PATH lookup Path to claude binary
--no-inherit-hooks Disable user hook inheritance
--verbose Write timing traces to stderr
--check Run installation self-test and exit
--version -V Print version and exit
--help -h Print help

Exit codes

Code Meaning
0 Success
1 Assistant error (is_error: true in transcript)
2 Internal error (PTY spawn, hook setup, parse failure)
124 Timeout exceeded
130 Interrupted (SIGINT)

NEEDLE integration

Copy claude-print.yaml to ~/.needle/agents/ (handled automatically by install.sh).

Structure

  • docs/notes/ — design decisions, constraints, integration details
  • docs/plan/plan.md — complete implementation plan