Balanov/uncut

选用指南

AI 根据 README 整理 · 2026/11/2 03:36:10

使用方式

通过命令行使用，支持管道输入和 JSONL 事件输出，可配置会话恢复。

查看 README 依据

export UNCUT_BASE_URL="http://localhost:11434/v1" export UNCUT_MODEL="qwen3:8b" uncut "Explain this repository" ``` No API key is required by default for local endpoints. In PowerShell, set variables with `$env:UNCUT_BASE_URL = "..."` and `$env:UNCUT_MODEL = "..."`. Replace the example model with one actually installed on your machine; tool-call behavior depends on the model. ### Unix pipelines ```sh git diff | uncut "Review this diff. Do not edit files." cat failing-test.log | uncut "Find the likely cause" ```

Piped input is appended to the prompt verbatim. UNCUT accepts valid UTF-8 text and rejects invalid input rather than replacing bytes silently. ### JSONL events ```sh uncut --json "Run the tests and fix the failure" ``` The event stream contains `user`, `assistant`, `assistant_meta`, `tool`, and finally `done` or `error` records. Assistant messages include complete tool calls; tool messages include complete results. Usage and finish reasons are separate `assistant_meta` events. ### Sessions ```sh uncut --session .uncut/work.jsonl "Start the refactor"

部署要求

需要 Go 1.26 或更高版本以从源码构建，或直接下载预编译二进制。运行时需要配置模型和 API 密钥，本地模型可无需密钥。

查看 README 依据

[](LICENSE) [](go.mod) UNCUT is a tiny coding-agent harness for shell pipelines, CI jobs, containers, and agent experiments. It deliberately has no TUI, telemetry, plugin system, background agents, automatic retries, or context compaction.

go build -trimpath -ldflags="-s -w" -o bin/uncut ./cmd/uncut ``` On Windows, use `bin/uncut.exe` as the output path. ## Quick start Set a model and API key: ```sh export UNCUT_API_KEY="your-api-key" export UNCUT_MODEL="your-model-id" uncut "Inspect this repository and fix the failing tests" ``` For an OpenAI-compatible provider, also set its base URL: ```sh export UNCUT_BASE_URL="https://openrouter.ai/api/v1" ``` For a local Ollama server with an installed tool-capable model (this exact setup was smoke-tested with `qwen3:8b`): ```sh ollama pull qwen3:8b

已知限制

不支持图像输入，拒绝二进制文件和无效 UTF-8，且不提供沙箱保护，模型可执行系统命令。

查看 README 依据

Binary files and invalid UTF-8 are rejected explicitly. UNCUT uses non-streaming Chat Completions and supports text plus tool calls, not images. ## Safety **UNCUT is not a sandbox.** The model can execute shell commands with your operating-system user's permissions. Workspace checks on file tools do not constrain what a shell command can access. Run untrusted tasks in a disposable container or isolated environment, and review sessions and changes yourself. There are no approval popups, automatic commits, automatic retries, or hidden recovery loops. ## Verify the lossless contract