# teai

teai 是 Gitea 的命令列（CLI）輔助工具，補足官方 `tea` CLI 缺少的功能。
名稱取「**te**a + **AI**」：這套工具主要為了讓 AI agent 能以更完整、更可靠的
方式操作 Gitea（查詢、回覆、審核、自動化……）。

- **語言：** Go（與 Gitea 本體一致）
- **目標站點：** `https://gitea.alterminal.com`
- **狀態：** 專案初始化中，功能尚未開始開發

## 安裝與建置

需要 Go 1.26 以上。

```sh
go build -o teai ./cmd/teai
```

## 使用方式

```sh
# 目前僅提供骨架
./teai            # 顯示說明
./teai version    # 顯示版本資訊
```

離線環境可直接建置：本專案目前僅使用 Go 標準庫，沒有外部相依。

## 開發

```sh
go build ./...    # 建置全部套件
go test ./...     # 跑全部測試
go vet ./...      # 靜態檢查
```

套件結構：

| 路徑 | 內容 |
| --- | --- |
| `cmd/teai/` | 程式進入點（`main`） |
| `internal/cli/` | 命令列架構（flag 剖析、子命令分派、輸出） |
| `internal/` 其他子套件 | 之後依功能新增（如 `internal/gitea`、`internal/cmds/`） |

### 慣例

- 文件與溝通一律使用**繁體中文**
- 對外行為（CLI 輸出、錯誤訊息）以英文為主，方便除錯與自動化剖析
- 變更一律走 **feature 分支 + Pull Request**，由審核者合併；不直推 `main`
- Commit 訊息與 PR 標題使用繁體中文或英文皆可，但需簡潔明確

## 授權

尚未決定（待維護者選定，例如 MIT／Apache-2.0）。