# kreel

**Repository Path**: jr-soft/kreel

## Basic Information

- **Project Name**: kreel
- **Description**: 轻量、单二进制、跨平台的 HTTP/HTTPS 请求工具，参数克制、退出码稳定、可选机器可读输出。 
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-16
- **Last Updated**: 2026-05-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KReel

轻量、单二进制的 **HTTP(S)** 与 **WebSocket** 命令行客户端（Go）。HTTP 模式支持 **multipart（`-F`/`--form`）**、**重试**、代理、`--fail`、JSON 行输出等；**`kreel ws`** 子命令用于 `ws://` / `wss://` 文本帧交互（stdin 每行发送一条，收到帧打印到 stdout）。

> KReel **不是** [curl](https://curl.se/) 官方产品；参数与行为与 curl **不保证**兼容。

详细产品与交付阶段见：

- [docs/KReel独立项目开发方案.md](./docs/KReel独立项目开发方案.md)
- [docs/KReel开发步骤.md](./docs/KReel开发步骤.md)

## 构建

```bash
go build -o kreel ./cmd/kreel
```

## 快速示例（Unix shell）

```bash
./kreel https://httpbingo.org/get
./kreel -X POST https://httpbingo.org/post --json @body.json
./kreel --output-format json https://httpbingo.org/get
HTTPS_PROXY=http://127.0.0.1:8080 ./kreel https://example.com
./kreel --retry 3 --retry-delay 1 https://httpbingo.org/status/503
./kreel ws wss://echo.websocket.events
./kreel ws -h
```

## Windows（PowerShell）注意

含 `&`、`?` 等字符的 URL 请用引号包裹，例如：

```powershell
.\kreel.exe "https://httpbingo.org/get?a=1&b=2"
```

## 帮助

```bash
./kreel -h
```

## 许可证

MIT，见 [LICENSE](./LICENSE)。