vg-coder-cli
Advanced tools
🚀 CLI tool to analyze projects, concatenate source files, count tokens, and export HTML with syntax highlighting and copy functionality
🚀 Powerful CLI tool & API Server để phân tích dự án, nối file mã nguồn, đếm token, xuất HTML và thực thi bash scripts qua REST API.
.gitignore: Tuân thủ chuẩn Git với multi-level ignore rules.vgignore: Có độ ưu tiên cao hơn .gitignore, với cú pháp giống hệtnode_modules, dist, .git, build, targettiktoken để đếm token chính xác cho AI models-c sao chép toàn bộ code vào clipboardcombined.txt với định dạng thân thiện cho AIvg startGET /health - Health checkPOST /api/analyze - Phân tích dự án, download project.txtGET /api/info - Lấy thông tin dự án (JSON)POST /api/execute - Thực thi bash scripts với validationDELETE /api/clean - Xóa output directory# Global install
npm install -g vg-coder-cli
# Local install
npm install vg-coder-cli
git clone https://github.com/tinhthanh/vg-coder-cli.git
cd vg-coder-cli
npm install
# Phân tích và xuất HTML
vg analyze
vg a # Alias rút gọn
# Với options
vg analyze /path/to/project --max-tokens 8192 --output ./my-output
# Copy vào clipboard (không tạo file)
vg analyze -c
vg analyze --clipboard
vg info
vg info /path/to/project
vg clean
vg clean --output ./my-output
# Start server (mặc định port 6868)
vg start
vg s # Alias rút gọn
# Custom port
vg start -p 8080
# Browser tự động mở dashboard tại http://localhost:6868
GET http://localhost:6868/health
Response:
{
"status": "ok",
"version": "1.0.10",
"timestamp": "2025-11-24T15:00:00.000Z"
}
POST http://localhost:6868/api/analyze
Content-Type: application/json
{
"path": ".",
"options": {
"maxTokens": 8000
}
}
Response: Downloads project.txt file
GET http://localhost:6868/api/info?path=.
Response:
{
"path": "/path/to/project",
"primaryType": "nodejs",
"stats": {
"totalFiles": 42,
"totalSize": 123456,
"totalLines": 5000
},
"tokens": {
"total": 15000,
"averagePerFile": 357
}
}
POST http://localhost:6868/api/execute
Content-Type: application/json
{
"bash": "mkdir -p $(dirname \"src/test.js\")\ncat <<'EOF' > src/test.js\nconsole.log('Hello');\nEOF"
}
Response:
{
"success": true,
"stdout": "",
"stderr": "",
"exitCode": 0,
"executionTime": 15
}
Features:
.vg/temp-executeDELETE http://localhost:6868/api/clean
Content-Type: application/json
{
"output": "./vg-output"
}
| Option | Mô tả | Default |
|---|---|---|
-o, --output <path> | Thư mục output | ./vg-output |
-m, --max-tokens <number> | Số token tối đa mỗi chunk | 8000 |
-t, --model <model> | Model AI để đếm token | gpt-4 |
--extensions <list> | Extensions (comma-separated) | Auto-detect |
--include-hidden | Bao gồm file ẩn | false |
--no-structure | Không giữ cấu trúc file | false |
--theme <theme> | Theme cho syntax highlighting | github |
-c, --clipboard | Copy vào clipboard | false |
--save-txt | Lưu vào vg-projects.txt | false |
| Option | Mô tả | Default |
|---|---|---|
-p, --port <port> | Port cho server | 6868 |
Khi chạy vg start, browser tự động mở dashboard với:
Xem file SYSTEM_PROMPT.md để biết cách tích hợp với AI.
Command Prefixes:
/ask - Q&A mode (Markdown response)/plan - Planning mode (Checklist + bash)/fix - Bug fix mode (Analysis + solution)/code - Code generation (Bash script only)Khi AI generate code với /code, format chuẩn:
mkdir -p $(dirname "path/to/file.ext")
cat <<'EOF' > path/to/file.ext
... file content ...
EOF
Quy tắc:
mkdir -p $(dirname "...") trước mỗi file<<'EOF' (có quotes) để tránh expansionvg-output/
├── index.html # Trang chính với navigation
├── combined.html # Tất cả code, có search
├── combined.txt # Text format, tối ưu cho AI
├── chunks/ # Chunks riêng biệt
│ ├── chunk-1.html
│ └── ...
└── assets/ # CSS, JS
Thứ tự ưu tiên:
.vgignore - Cao nhất.gitignore - Trung bình# Analyze project và copy vào clipboard
vg a . -c
# Paste vào AI tool (Claude, ChatGPT, etc.)
# 1. Start server
vg start
# 2. Browser mở dashboard tự động
# 3. Test endpoints trực tiếp trên UI
# 4. Hoặc dùng Postman/curl
# 5. Execute bash script từ AI
curl -X POST http://localhost:6868/api/execute \
-H "Content-Type: application/json" \
-d '{"bash": "mkdir -p src && echo \"test\" > src/file.js"}'
# 1. Analyze project
vg a . -c
# 2. Paste vào AI với prompt:
# "/code Thêm authentication vào project này"
# 3. AI trả về bash script
# 4. Copy bash script
# 5. Execute qua API
curl -X POST http://localhost:6868/api/execute \
-H "Content-Type: application/json" \
-d '{"bash": "..."}'
# Install dependencies
npm install
# Run tests
npm test
# Run in dev mode
npm run dev
# Build and publish
npm run push
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)MIT License - xem file LICENSE để biết thêm chi tiết.
vg, a, -c, sFAQs
🚀 CLI tool to analyze projects, concatenate source files, count tokens, and export HTML with syntax highlighting and copy functionality
The npm package vg-coder-cli receives a total of 786 weekly downloads. As such, vg-coder-cli popularity was classified as not popular.
We found that vg-coder-cli demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
TrapDoor crypto stealer hits 36 malicious packages across npm, PyPI, and Crates.io, targeting crypto, DeFi, AI, and security developers.
Research
/Security News
Laravel Lang packages were compromised with an RCE backdoor across hundreds of versions, exposing cloud, CI/CD, and developer secrets.
Security News
Socket found a malicious postinstall hook across 700+ GitHub repos, including PHP packages on Packagist and Node.js project repositories.