Metadata-Version: 2.4
Name: agmx
Version: 0.1.0
Summary: Chạy việc của AgentMatrix ngay trên máy bạn, bằng phiên đăng nhập CLI của chính bạn.
Author: lupca
License-Expression: MIT
Project-URL: Homepage, https://github.com/lupca/AgentMatrix
Project-URL: Source, https://github.com/lupca/AgentMatrix/tree/main/runner
Keywords: agmx,agentmatrix,coding-agent,runner
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Build Tools
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.24

# agmx

Chạy việc của AgentMatrix ngay trên **máy bạn**, bằng phiên đăng nhập CLI của
chính bạn. Gói này chỉ cần Python và `httpx`: không Postgres, không Redis,
không `DATABASE_URL` của control plane.

## Cài

```bash
pipx install ./runner          # hoặc: pipx install agmx
```

## Dùng

```bash
agmx login                                  # hỏi email + mật khẩu, cất token
agmx runner start --project agmx=~/code/AgentMatrix
```

`--project` lặp lại được nhiều lần. Server **chỉ** gửi `project_id`; đường dẫn
thật do máy này quyết định, và một `project_id` chưa đăng ký ở đây bị báo
`failed` chứ không bao giờ bị đoán thành một thư mục nào đó.

## Cấu hình ở đâu

| File | Quyền | Chứa gì |
|---|---|---|
| `~/.agmx/.credentials.json` | `0600` | token đăng nhập |
| `~/.agmx/settings.json` | `0644` | `server`, `email`, `runner_id` |

`AGMX_CONFIG_DIR` đổi được thư mục. File `config.json` một-cục của bản cũ vẫn
đọc được, và được dọn đi ở lần ghi kế tiếp.

## Một run chạy như thế nào

Mỗi run được cấp một `git worktree` riêng trên nhánh `ct-run/<run_id>`, cắt từ
HEAD hiện tại. Lệnh chạy trong worktree đó, output đẩy về server theo mẻ trong
lúc đang chạy. Xong thì `git add -A` + commit, gỡ worktree nhưng **giữ nhánh**:
commit sống tiếp trong repo chính.

Runner **không phán xét**: nó báo mã thoát, `base_sha`, `head_sha`, có quá giờ
hay không. Ai thành ai bại là việc của server.
