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
98 commits 1 branch 0 tags 100 MiB
Rust 98.8%
Shell 1.2%
Find a file
jedarden bbe18cbfb1 docs(bf-3ag): verify session implementation complete - all tests pass
2026-06-13 14:52:20 -04:00
.beads feat(session): implement Session struct and version resolution 2026-06-13 13:41:32 -04:00
docs docs(adr): add ADR-004 — no silent agent escalation in NEEDLE workers 2026-06-11 07:31:56 -04:00
notes docs(bf-3ag): verify session implementation complete - all tests pass 2026-06-13 14:52:20 -04:00
src test(session): fix version resolution test and add struct validation test 2026-06-13 14:20:58 -04:00
test-fixtures/mock-claude Add bf-5nr validation notes: claude-print-ci WorkflowTemplate YAML is valid 2026-06-10 02:11:37 -04:00
tests Add bf-5nr validation notes: claude-print-ci WorkflowTemplate YAML is valid 2026-06-10 02:11:37 -04:00
AGENTS.md docs(agents): add src/lib.rs to module map in AGENTS.md 2026-06-10 20:47:17 -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