claude-p - GitLite

KO | EN

gitlite — search

#computer-vision #graphql #nextjs #chatgpt #bash #awesome-list #claude #redis #markdown #tailwindcss

claude-p

(★ 391)

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

파일 탐색기

ZIP 다운로드

- - 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

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

명령어 용어집

이 문서에서 사용된 명령어를 모아봤습니다. 낯선 명령어가 있다면 펼쳐서 확인해보세요.

🔍

`claude`

설명 보기 ▼

코드베이스를 이해하고 자연어 명령을 통해 더 빠르게 코딩할 수 있도록 도와주는 에이전트 기반 코딩 도구.
더 많은 정보: <https://code.claude.com/docs/en/cli-reference>.

claude prompt

프롬프트로 실행:

claude update

`claude`를 업데이트:

claude mcp list

지정된 MCP 서버 목록을 표시:

🔍

`git clone`

설명 보기 ▼

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`

설명 보기 ▼

이 명령은 `npm exec`의 별칭입니다.

tldr npm exec

자세한 내용은 원본 명령을 참고하세요:

🔍

`zig`

설명 보기 ▼

Zig 컴파일러 및 툴체인.
더 많은 정보: <https://ziglang.org/documentation/master/>.

zig build

현재 디렉토리의 프로젝트 컴파일:

zig build run

현재 디렉토리의 프로젝트 컴파일 및 실행:

zig init

`zig build` 애플리케이션 초기화:

// 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.