Metadata-Version: 2.4
Name: tjagentforge-agent
Version: 0.1.0
Summary: TjAgentForge CLI Agent — local executor that proxies your local git repos (branch / apply patch / commit / push) with source code never leaving your machine.
License: MIT
Keywords: ai,agent,cli,git,automation,game-ops
Author: TjAgentForge
Author-email: dev@tjagentforge.com
Requires-Python: >=3.11,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Version Control :: Git
Requires-Dist: websockets (>=14,<15)
Description-Content-Type: text/markdown

# TjAgentForge CLI Agent

TjAgentForge 的本地执行组件（daemon）。它运行在你的机器上，通过 WebSocket 长连接接收 TjAgentForge SaaS 平台下发的任务，代理执行**本地 git 仓库操作**（开分支 / 应用补丁 / 提交 / 推送），**源码永不离开你的电脑**。

## 特性

- 长连接 + 心跳 + 断线自动重连
- 任务白名单：只执行 `git.open_pr` / `git.status` 等白名单任务（框架预留 `build` / `package` / `device`）
- 最小权限：每次任务执行需你在网页端显式授权

## 安装

需要 Python 3.11+。

```bash
pip install tjagentforge-agent
```

## 使用

1. 在 TjAgentForge 控制台「CLI Agent」页生成连接 Token。
2. 启动 Agent：

```bash
tjagentforge-agent --server wss://<your-host>/api/v1/agent/ws --token <TOKEN>
```

3. 在控制台确认 Agent 显示「在线」，即可在「代码修复」页选择「本地仓库」执行修复任务。

## 参数

| 参数 | 必填 | 说明 |
| :-- | :-- | :-- |
| `--server` | 是 | 服务端 WebSocket 地址，如 `wss://host/api/v1/agent/ws` |
| `--token` | 是 | 控制台生成的连接 Token |
| `--agent-id` | 否 | Agent 唯一 ID（默认 hostname + 随机后缀） |

## 安全说明

Agent 仅执行白名单内的任务，且每次执行都需你在网页端授权；可随时断开或卸载。

