# harness-code

**Repository Path**: chrisjingxin/harness-code

## Basic Information

- **Project Name**: harness-code
- **Description**: 基于langchain的coding agent cli
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-21
- **Last Updated**: 2026-07-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Harness Code（za38-cli）

Harness Code 是面向企业研发场景的 Coding Agent CLI。终端交互由 Bun/OpenTUI 提供，Agent 内核基于 Python、deepagents、LangChain 和 LangGraph，并通过 stdio JSON-RPC 通信。

> 当前处于开发态：请从源码运行。跨平台安装包以及 `curl`、PowerShell、CMD 安装器尚未交付，不能将其视为可用的生产安装方式。

## 开始使用

本地开发固定使用 Bun `1.2.19`、Python 3.11+ 和 `uv`。先在企业索引环境中同步锁定的 Agent 依赖，再复制用户级示例配置并将 API Key 放入指定环境变量：

```bash
mkdir -p ~/.harness
cd packages/agent && uv sync --extra test && cd ../..
cp docs/user/examples/config.toml ~/.harness/config.toml
export HARNESS_API_KEY='你的企业网关密钥'
bun run dev
```

推荐通过 `api_key_env` 引用环境变量。若本机开发环境无法预先设置环境变量，可在权限为 `0600` 的 `~/.harness/config.toml` 模型 Profile 中设置 `api_key` 作为降级值；环境变量非空时始终优先。

可使用 `bun run dev -- --help` 查看当前 CLI 参数；无头运行示例：

```bash
bun run dev -- --non-interactive --message "解释当前目录的项目结构"
```

详细说明：

- [快速开始](docs/user/快速开始.md)
- [模型配置](docs/user/模型配置.md)
- [交互使用](docs/user/交互使用.md)
- [安全与沙箱](docs/user/安全与沙箱.md)
- [故障排查](docs/user/故障排查.md)

终端界面使用企业源的 `@opentui/core` / `@opentui/react` `0.4.3`、React `19.2.6` 和 `react-reconciler` `0.33.0`。企业引入 OpenTUI Core 时须同时镜像其目标平台 native optional packages；项目不再携带本地 Core 源码或自行构建的 FFI artifact。

参与开发请从 [开发工作流](docs/developer/开发工作流.md) 开始；任务以 [任务看板](docs/developer/任务看板.md) 和任务源文件为准。