claude-p - GitLite

KO | EN

gitlite — search

#pytorch #kubernetes #web #llm #proxy #cpp #github #shell #mysql #gpt

claude-p

(★ 391)

Drop-in replacement for `claude -p` that drives the interactive Claude Code TUI inside an in-process zmux PTY session.

File Explorer

ZIP Download

- - ci.yml
  - release.yml
- claude-p.js
- build-in-linux.sh
- install.js
- publish.mjs
- args.zig
- daemon.zig
- driver.zig
- emit.zig
- hook.zig
- main.zig
- root.zig
- stream.zig
- terminal.zig
- transcript.zig
- integration.zig
.gitignore
.npmignore
build.zig
build.zig.zon
CLAUDE.md
package.json
README.md
REPORT.md
SPEC.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

Command Glossary

Commands referenced in this DOCs, explained below.

🔍

`claude`

View Details ▼

An agent-based coding tool that understands your code base and helps you code faster through natural language commands.

claude prompt

Execute with prompt:

claude update

Update `claude`:

claude mcp list

Get the list of specified MCP servers:

🔍

`git clone`

View Details ▼

Clone an existing repository.

git clone {{remote_repository_location}} {{path/to/directory}}

Clone an existing repository into a new directory (the default directory is the repository name):

git clone --recursive {{remote_repository_location}}

Clone an existing repository and its submodules:

git clone {{[-n|--no-checkout]}} {{remote_repository_location}}

Clone only the `.git` directory of an existing repository:

🔍

`npx`

View Details ▼

This command is an alias of `npm exec`.

tldr npm exec

View documentation for the original command:

🔍

`zig`

View Details ▼

The Zig compiler and toolchain.

zig build

Compile the project in the current directory:

zig build run

Compile and run the project in the current directory:

zig init

Initialize a `zig build` project with library and executable:

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

> **Use at your own risk.** This package and repository exist for
> **educational purposes** and demonstrates why client-side restrictions
> on how a product is used are fundamentally unenforceable.

A drop-in replacement for `claude -p` that drives the interactive
`claude` UI inside an in-process [zmux][zmux] PTY session.

[zmux]: https://github.com/smithersai/zmux

Built using [smithers](https://github.com/smithersai/smithers) self-improving harness

## Use

```bash
npx claude-p "your prompt here"
```

Output on stdout matches `claude -p` byte-for-byte.

```bash
npx claude-p --output-format json "summarize this commit" < commit.diff
npx claude-p --output-format stream-json "audit src/" --verbose | jq .
npx claude-p --model opus "explain quicksort to a 10-year-old"
```

## How it works

1. Spawns `claude` interactively inside a [zmux][zmux] `NativeSession`
   (a real PTY with a reader thread and bounded scrollback).
2. A small ANSI scanner answers the DA1 / DA2 / DSR / XTVERSION /
   window-size queries Ink (the React-for-terminals runtime Claude
   Code uses) issues at startup. Without these, the TUI hangs.
3. Registers two hooks via `--settings '<inline-json>'` — never
   touches your `~/.claude/` config:
   - **`SessionStart`** — the wrapper types the prompt + Enter.
   - **`Stop`** — fires when the model finishes; payload carries
     `transcript_path`.
4. Reads the transcript JSONL, extracts the final assistant message
   plus usage, and prints in the requested format.

## Flags

```
--output-format <text|json|stream-json>   default: text
--model <name>
--fallback-model <name>
--max-turns <N>
--allowedTools <list>
--disallowedTools <list>
--permission-mode <acceptEdits|auto|bypassPermissions|default|dontAsk|plan>
--dangerously-skip-permissions
--system-prompt <text>
--append-system-prompt <text>
--add-dir <dir>...                        repeatable, variadic
--mcp-config <cfg>...                     repeatable, variadic
--setting-sources <user,project,local>
--resume <id> | --continue | --session-id <uuid>
--cwd <path>
--input-file <path>
--verbose
--timeout <seconds>                       default: 300
--debug
--                                        end-of-options, remaining tokens go to PROMPT
```

Unrecognized flags are forwarded verbatim to `claude`. `-p`/`--print` and
user-supplied `--settings` are rejected — claude-p emulates print mode and
injects its own settings to register the Stop hook.

## Exit codes

| Code  | Meaning                                                               |
| ----- | --------------------------------------------------------------------- |
| `0`   | Success.                                                              |
| `1`   | Assistant returned an error (`is_error: true`) or transcript missing. |
| `2`   | Wrapper internal error (PTY failure, spawn failed, etc.).             |
| `124` | Timed out or `--max-turns` exceeded.                                  |
| `130` | Interrupted (SIGINT).                                                 |

## Caveats

- **macOS / Linux only.** No Windows (no `forkpty`).
- **Requires `claude` on `$PATH`.** The wrapper invokes the real CLI.
- **Per-message streaming, not per-token.** With
  `--output-format stream-json`, transcript lines (user messages, tool
  uses, assistant turns, the trailing `result` envelope) are emitted
  to stdout the moment `claude` flushes them. Individual tokens within
  a single assistant message are not streamed — those require
  `claude -p --include-partial-messages` which is only available in
  claude's native `--print` mode.
- **Adds ~50–200 ms** over `claude -p` due to PTY + Ink startup
  overhead.
- **Multiline prompts** must come via `--input-file` or stdin to keep
  shell escaping sane.
- **API instability.** `claude` is not designed to be driven this way.
  A future Claude Code release that changes the hook payload schema or
  adds a new terminal probe at startup can break us; the wrapper will
  surface the failure rather than hide it.

## From source

```bash
git clone https://github.com/smithersai/claude-p
cd claude-p
zig build -Doptimize=ReleaseSafe
```

Requires Zig **0.15.2**. Dependencies are fetched by `zig build`.

## As a Zig library

```sh
zig fetch --save=claude_p git+https://github.com/smithersai/claude-p
```

```zig
const std = @import("std");
const claude_p = @import("claude_p");

pub fn main() !void {
    var gpa: std.heap.GeneralPurposeAllocator(.{}) = .{};
    defer _ = gpa.deinit();
    const alloc = gpa.allocator();

var result = try claude_p.run(alloc, .{
        .prompt = "what is the capital of France?",
        .output_format = .text,
        .skip_permissions = true,
    });
    defer result.deinit(alloc);

std.debug.print("{s}\n", .{result.summary.final_text});
}
```

The `Options` struct mirrors the CLI flags 1:1. See `src/root.zig` and
[`SPEC.md`](./SPEC.md) for the full API.

## License

MIT.