{"id":50757680,"url":"https://github.com/phuonghx/aim-cli","last_synced_at":"2026-06-11T07:00:27.654Z","repository":{"id":363733239,"uuid":"1264676180","full_name":"phuonghx/aim-cli","owner":"phuonghx","description":"Centralized project memory, task tracker, and instruction synchronizer for AI coding assistants (Claude Code, Antigravity, Cursor, Windsurf, Copilot).","archived":false,"fork":false,"pushed_at":"2026-06-10T05:05:58.000Z","size":517,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-10T07:09:37.751Z","etag":null,"topics":["ai-agents","ai-native","antigravity","calude","claude-code","cli","cursorrules","developer-tools","memory","task-management"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phuonghx.png","metadata":{"files":{"readme":"README-VI.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-10T04:57:45.000Z","updated_at":"2026-06-10T05:05:50.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/phuonghx/aim-cli","commit_stats":null,"previous_names":["phuonghx/aim-cli"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/phuonghx/aim-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phuonghx%2Faim-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phuonghx%2Faim-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phuonghx%2Faim-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phuonghx%2Faim-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phuonghx","download_url":"https://codeload.github.com/phuonghx/aim-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phuonghx%2Faim-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34186385,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","ai-native","antigravity","calude","claude-code","cli","cursorrules","developer-tools","memory","task-management"],"created_at":"2026-06-11T07:00:18.885Z","updated_at":"2026-06-11T07:00:27.645Z","avatar_url":"https://github.com/phuonghx.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bộ Công Cụ Đồng Bộ AI Agent — AIM 🎯\n\n**AIM** (AI Memory / Mind) là bộ công cụ đồng bộ cấu hình, phím tắt lệnh (slash commands), quản lý tác vụ (tasks) và tài liệu (docs) dành cho các trợ lý AI thông minh bao gồm **Claude Code**, **Antigravity**, và **Codex (Cursor / Windsurf / GitHub Copilot)**.\n\nAIM đóng vai trò như một bộ nhớ tập trung, tự động biên dịch một file cấu hình duy nhất (`.ai-context/config.json`) thành các file hướng dẫn tương thích với từng AI client (`CLAUDE.md`, `ANTIGRAVITY.md`, `.cursorrules`, `.github/copilot-instructions.md`), đồng thời cài đặt toàn bộ 20 agent chuyên biệt, 45 skill và 13 workflow từ AIM.\n\n---\n\n## 🏗️ Cấu Trúc Thư Mục\n\n```plaintext\naim-cli/\n├── .github/\n│   └── workflows/\n│       └── release.yml           # Quy trình đóng gói và release tự động của GitHub Actions\n├── aim/                          # Thư mục module chứa code chính\n│   ├── templates/                # Toàn bộ agent, skill và workflow của AIM\n│   ├── skills/                   \n│   ├── __init__.py\n│   ├── aim_cli.py                # Bộ lõi thực thi các lệnh CLI của AIM\n│   ├── browser_server.py         # Máy chủ web Dashboard\n│   └── sync.py                   # Kịch bản đồng bộ shims độc lập\n├── .gitignore\n├── install.ps1                   # Kịch bản cài đặt một dòng cho Windows PowerShell\n├── install.sh                    # Kịch bản cài đặt một dòng cho macOS/Linux Bash\n├── MANIFEST.in                   # File manifest khai báo file đính kèm khi đóng gói\n├── setup.py                      # Kịch bản cài đặt package\n├── setup.bat                     # File chạy nhanh trên Windows để kích hoạt cài đặt\n├── aim.bat                       # File wrapper cho Windows (chạy lệnh aim trực tiếp)\n├── aim.sh                        # File wrapper cho Bash (Unix)\n└── README.md                     # Tài liệu hướng dẫn tiếng Anh\n```\n\n---\n\n## 🚀 Hướng Dẫn Cài Đặt \u0026 Khởi Tạo\n\nĐể khởi tạo AIM trong dự án của bạn:\n\n### Trên Windows\nBạn chỉ cần click đúp vào file `setup.bat` hoặc chạy lệnh trong PowerShell/CMD:\n```powershell\n.\\setup.bat\n```\n\nSau khi chạy xong, bộ cài sẽ tự động tạo:\n- `aim.bat`: Cho phép bạn gõ trực tiếp `aim \u003clệnh\u003e` trong CMD hoặc PowerShell.\n- `aim.sh`: Cho phép bạn gõ `aim` trên môi trường Unix/Linux/macOS.\n\n---\n\n## 🔄 Đồng Bộ Hóa Hướng Dẫn (Sync)\n\nKhi bạn thay đổi công nghệ sử dụng, lệnh build/test, hoặc thêm quy tắc lập trình mới trong tệp `.ai-context/config.json`, hãy đồng bộ lại ra các AI Client bằng lệnh:\n\n```bash\naim sync\n# hoặc: python aim/sync.py\n```\n\nLệnh này sẽ tự động cập nhật các file:\n* **Claude Code**: file `CLAUDE.md` (chứa lệnh build, test, quy tắc phong cách viết code và tối ưu hóa).\n* **Antigravity**: file `ANTIGRAVITY.md` (chứa quy tắc lập kế hoạch Planning Mode, tra cứu Knowledge Items và kiểm chứng code).\n* **Codex (Cursor / Windsurf)**: file `.cursorrules` và `.windsurfrules` (chứa quy tắc UI/UX, cách thiết kế giao diện hiện đại và các quy tắc đặc thù).\n* **GitHub Copilot**: file `.github/copilot-instructions.md` (chứa ngữ cảnh dự án và ràng buộc công nghệ).\n\n---\n\n## 🛠️ Danh Sách Các Lệnh CLI\n\n### 1. Quản Lý Tác Vụ \u0026 Cấu Trúc Nhánh (Task \u0026 Subtask Management)\nGiao tác vụ cho AI lập kế hoạch, theo dõi tiến độ, tạo cấu trúc cây nhiệm vụ (subtasks) và quản lý tags nhãn.\n\n```bash\n# Tạo một task mới (hỗ trợ parent task ID, labels nhãn, spec và plan)\naim task create \"Tên tác vụ\" -d \"Mô tả chi tiết\" --ac \"Tiêu chí 1\" -p high -a \"alice\" --parent 1 -l bug -l seo --spec \"@doc/sdd/seo.md\"\n\n# Liệt kê danh sách task (hiển thị dưới dạng cây phân cấp thụt lề cùng nhãn)\naim task list\n\n# Xem chi tiết một task\naim task view \u003cid\u003e\n\n# Cập nhật trạng thái, thêm/xóa nhãn, cập nhật spec/plan\naim task edit \u003cid\u003e -s in-progress --parent 2 --add-label frontend --remove-label bug -d \"Mô tả mới\"\naim task edit \u003cid\u003e --check-ac 1     # Đánh dấu tiêu chí nghiệm thu số 1 là xong (1-based)\n```\n\n### 1.5. Quản Lý Thành Viên (User Management)\nQuản lý danh sách thành viên dự án và tự động cập nhật khi giao việc.\n\n```bash\n# Liệt kê danh sách thành viên\naim user list\n\n# Thêm thành viên mới\naim user add \u003cusername\u003e\n\n# Đổi tên thành viên (tự động đồng bộ các task đang giao cho thành viên cũ)\naim user rename \u003cold_username\u003e \u003cnew_username\u003e\n\n# Xóa thành viên (ngoại trừ các thành viên hệ thống mặc định)\naim user remove \u003cusername\u003e\n```\n\n### 1.6. Trạng Thái Dự Án \u0026 Bảng Kanban ASCII\nKiểm tra thống kê sức khỏe dự án và xem trực quan các task dưới dạng bảng Kanban ASCII ngay trong terminal.\n\n```bash\n# Xem báo cáo tóm tắt trạng thái dự án (thông số về tasks, docs, memories, time tracking và sync health)\naim status\n\n# Hiển thị các task sắp xếp theo bảng Kanban ASCII (cột: TODO, IN-PROGRESS, IN-REVIEW, DONE)\naim board\n```\n\n### 1.7. Theo Dõi Thời Gian Làm Việc (Time Tracking)\nTheo dõi thời gian chính xác bạn làm việc cho các task cụ thể trực tiếp từ CLI.\n\n```bash\n# Bắt đầu tính giờ cho một task\naim time start \u003ctask_id\u003e\n\n# Xem trạng thái bộ đếm giờ hiện tại đang chạy\naim time status\n\n# Dừng bộ đếm giờ hiện tại và ghi chú (tùy chọn)\naim time stop -n \"Đã triển khai tính năng X\"\n\n# Xem nhật ký thời gian của một task cụ thể\naim time log \u003ctask_id\u003e\n\n# Xuất báo cáo tổng hợp thời gian làm việc toàn dự án\naim time report\n```\n\n### 1.8. Mẫu Sinh Code (Code Generation Templates)\nKhởi tạo, xem và thực thi các mẫu tạo mã nguồn tái sử dụng với các biến động và bộ chuyển đổi kiểu chữ (casing helpers):\n\n```bash\n# Liệt kê tất cả các mẫu hiện có\naim template list\n\n# Tạo khung mẫu mới (tạo thư mục cấu hình trong .ai-context/templates/\u003ctên_mẫu\u003e/)\naim template create \u003ctên_mẫu\u003e\n\n# Xem nội dung cấu hình của một mẫu cụ thể\naim template view \u003ctên_mẫu\u003e\n\n# Thực thi mẫu sinh code (sẽ hỏi các biến còn thiếu nếu chưa truyền)\naim template run \u003ctên_mẫu\u003e\n\n# Thực thi với các biến được định nghĩa sẵn\naim template run \u003ctên_mẫu\u003e -v name=\"MyComponent\"\n\n# Chạy thử (dry-run) để xem trước các tệp sẽ được tạo mà không ghi xuống đĩa\naim template run \u003ctên_mẫu\u003e --dry-run -v name=\"MyComponent\"\n```\n\n### 2. Quản Lý Tài Liệu (Structured Documentation)\nTạo, duyệt và đọc các tài liệu hướng dẫn nằm trong `.ai-context/docs/`.\n\n```bash\n# Tạo một doc mới\naim doc create \"Thiết Kế API\" -f \"architecture\" -d \"Hướng dẫn thiết kế API JWT\"\n\n# Liệt kê tài liệu\naim doc list\n\n# Đọc nội dung tài liệu\naim doc view architecture/thiet-ke-api\n```\n\n### 3. Bộ Nhớ Bền Vững (Persistent Memory)\nLưu lại các quyết định thiết kế, quy chuẩn code để AI tự động nhớ và tái sử dụng qua các phiên chat.\n\n```bash\n# Thêm một quyết định hoặc quy chuẩn vào bộ nhớ dự án\naim memory add \"Sử dụng repository pattern cho các giao dịch database\" -c decision -l project\n\n# Liệt kê bộ nhớ\naim memory list\n```\n\n### 4. Tìm Kiếm Cục Bộ (Search)\nTìm kiếm nhanh chóng theo từ khóa hoặc regex trên toàn bộ tasks, tài liệu và bộ nhớ:\n\n```bash\naim search \"api\"\n```\n\n### 5. Kiểm Tra Liên Kết (Validate)\nQuét toàn bộ tài liệu và tác vụ để phát hiện các liên kết bị lỗi (ví dụ `@task-X` hoặc `@doc/path` trỏ tới đối tượng không tồn tại):\n\n```bash\naim validate\n```\n\n---\n\n## 💻 Giao Diện Web Dashboard (`aim browser`)\n\nKhởi chạy máy chủ Web Dashboard cục bộ để theo dõi trực quan và tương tác với toàn bộ bộ não dự án:\n```bash\naim browser\n```\n\n### Các Tính Năng Cao Cấp Trên Giao Diện Web:\n1. **🔮 Tổng Quan Dashboard**: Xem tiến độ hoàn thành task, biểu đồ thời gian hoạt động, nhật ký chấm công và các quyết định dự án gần đây.\n2. **📋 Kanban Task Board**:\n   * Bảng công việc kéo thả chia theo các trạng thái (Todo, In Progress, In Review, Done).\n   * Thẻ task hiển thị đầy đủ thông tin: nhãn (tags), liên kết Parent task, và số lượng subtasks con hoàn thành.\n   * Popup chi tiết task cho phép chỉnh sửa tiêu đề (inline), mô tả (textarea), nhãn tags, liên kết Spec/Plan tài liệu, và quản lý cây subtasks trực quan (click mở subtask, thêm nhanh subtask).\n3. **👥 Users Management**: Giao diện đăng ký, sửa tên (rename), và xóa thành viên dự án. Đổi tên thành viên tự động lan truyền và cập nhật tất cả task tương ứng.\n4. **🕸️ Knowledge Graph**: Đồ thị lực hướng (force-directed graph) biểu diễn mối tương quan và liên kết chéo giữa các Tasks và Tài liệu.\n5. **🔍 Command Palette (Search)**: Nhấn tổ hợp phím `Ctrl + K` (hoặc `Cmd + K`) để mở thanh tìm kiếm nhanh mọi lúc mọi nơi trên Dashboard.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphuonghx%2Faim-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphuonghx%2Faim-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphuonghx%2Faim-cli/lists"}