Personal Ai

README

# personal-ai-plugin

Personal AI Agent plugin สำหรับ AI tools ต่างๆ
รองรับหลาย AI tools ด้วย installer เดียว

---

## ภาพรวม

Plugin นี้เปลี่ยน AI tool ใดก็ได้ให้กลายเป็น **ผู้ช่วยส่วนตัว** ที่:

| ความสามารถ | คำอธิบาย |
|-----------|---------|
| **จดโน้ต** (`/note`) | สร้าง ค้นหา อ่าน ลบโน้ตใน `notes/` |
| **ติดตามงาน** (`/todo`) | เพิ่ม เช็ค ลบ TODO list |
| **ค้นคว้า** (`/research`) | ค้นหาข้อมูลจากเว็บพร้อมแหล่งอ้างอิง |
| **เช็คระบบ** (`/check-services`) | Docker, network, CPU/disk/memory |
| **สรุปประจำวัน** (`/daily-summary`) | git activity, containers, TODO ค้าง |
| **งานด่วน** (`/quick-task`) | แปลภาษา, คำนวณ, IP, สภาพอากาศ ฯลฯ |
| **Memory ข้ามเซสชัน** | Knowledge graph ผ่าน MCP server-memory |

---

## AI Tools ที่รองรับ

| Tool | โฟลเดอร์ | ประเภทไฟล์ |
|------|---------|-----------|
| Claude Code | `for-claude-code/` | `CLAUDE.md` + `.claude/commands/` + `.mcp.json` |
| OpenCode | `for-opencode/` | `AGENTS.md` |
| Codex CLI | `for-codex/` | `AGENTS.md` + `config.toml` |
| Codex App Server | `for-codex-appserver/` | `AGENTS.md` + `config.toml` |
| Gemini CLI | `for-gemini-cli/` | `GEMINI.md` + `settings.json` |
| Google Antigravity | `for-antigravity/` | `GEMINI.md` + skill |
| Google ADK | `for-google-adk/` | Python agent (`agent.py`) |
| gocode | `for-gocode/` | `AGENTS.md` |
| adkcode | `for-adkcode/` | plugin (skills + commands + `.mcp.json`) |
| GitHub Copilot CLI | `for-copilot-cli/` | `AGENTS.md` + `mcp-config.json` |
| Qwen Code | `for-qwen-code/` | `AGENTS.md` |
| OpenClaw | `for-openclaw/` | TypeScript npm plugin |

---

## วิธีติดตั้ง

### วิธีที่ 1: ใช้ install.sh (แนะนำ)

```bash
# Claude Code (default)
./install.sh /path/to/your-project

# ระบุ tool
./install.sh /path/to/project opencode
./install.sh /path/to/project codex
./install.sh /path/to/project codex-appserver
./install.sh /path/to/project gemini-cli
./install.sh /path/to/project antigravity
./install.sh /path/to/project gocode
./install.sh /path/to/project copilot-cli
./install.sh /path/to/project qwen-code

# ติดตั้งต่างออกไป
./install.sh . openclaw      # npm plugin
./install.sh . google-adk    # Python package
./install.sh . adkcode       # copy plugin directory
```

### วิธีที่ 2: Copy manual

Copy ไฟล์จากโฟลเดอร์ `for-xxx/` ที่ต้องการลงใน project โดยตรง

---

## Slash Commands (Claude Code)

| Command | คำอธิบาย |
|---------|----------|
| `/daily-summary` | สรุปสถานะระบบประจำวัน (Docker, disk, git) |
| `/check-services` | ตรวจสอบ Docker containers, network, resources |
| `/research [หัวข้อ]` | ค้นคว้าข้อมูลจากเว็บ พร้อมแหล่งอ้างอิง |
| `/note [action]` | จัดการโน้ตส่วนตัวใน `notes/` |
| `/todo [action]` | จัดการ TODO list |
| `/quick-task [คำสั่ง]` | งานด่วน (แปลภาษา, คำนวณ, IP ฯลฯ) |

---

## โครงสร้าง

```
personal-ai-plugin/
  agents/
    AGENT.md             — core agent persona (tool-agnostic)
  for-claude-code/       — Claude Code
  for-opencode/          — OpenCode
  for-codex/             — Codex CLI
  for-codex-appserver/   — Codex App Server
  for-gemini-cli/        — Gemini CLI
  for-antigravity/       — Google Antigravity
  for-google-adk/        — Google ADK (Python agent)
  for-gocode/            — gocode
  for-adkcode/           — adkcode (plugin system)
  for-copilot-cli/       — GitHub Copilot CLI
  for-qwen-code/         — Qwen Code
  for-openclaw/          — OpenClaw (TypeScript npm plugin)
  install.sh             — one-command installer
```

---

## Memory System

Plugin ใช้ 2 ระบบ memory ควบคู่กัน:

| ระบบ | เก็บอะไร | เทคโนโลยี |
|------|---------|-----------|
| **Auto Memory** | preferences, feedback, project info, references | Markdown files |
| **Knowledge Graph** | ความสัมพันธ์ระหว่าง entities (คน, โปรเจค, เทคโนโลยี) | MCP `server-memory` → `memory.jsonl` |

---

## ความต้องการ

- AI tool ที่รองรับ (Claude Code, OpenCode, ฯลฯ)
- Node.js (สำหรับ MCP server-memory — `npx @modelcontextprotocol/server-memory`)
- Python 3.11+ (เฉพาะ Google ADK)