Compare commits
6 Commits
615c324d9b
..
main
| Author | SHA1 | Date | |
|---|---|---|---|
| 0b7b8802d1 | |||
| b4be492dec | |||
| d25540d727 | |||
| 242e3fde38 | |||
| 5e5727f021 | |||
| 3012507fcc |
+8
-6
@@ -5,12 +5,14 @@ prompts:
|
||||
preset: "下面的代码来自文件 {{path}}:\n---\n{{content}}"
|
||||
|
||||
preset:
|
||||
all:
|
||||
- "cmd/*"
|
||||
- "internal/tree/*"
|
||||
- "internal/utils/*"
|
||||
- "internal/config/*"
|
||||
- "main.go"
|
||||
all:
|
||||
- "*"
|
||||
# - "cmd/*"
|
||||
# - "internal/tree/*"
|
||||
# - "internal/utils/*"
|
||||
# - "internal/config/*"
|
||||
# - "internal/resolver/*"
|
||||
# - "main.go"
|
||||
|
||||
internal:
|
||||
- "internal/tree/*"
|
||||
|
||||
@@ -0,0 +1,93 @@
|
||||
# cliprepo
|
||||
|
||||
`cliprepo` is a lightweight, efficient CLI tool written in Go that helps you package your repository's file tree and source code content into a formatted Markdown block. It is designed to quickly build comprehensive context for Large Language Models (LLMs) like GPT, Claude, or DeepSeek.
|
||||
|
||||
## Features
|
||||
|
||||
- **File Tree Generation**: Automatically generates a clean ASCII directory tree, honoring your `.gitignore` rules.
|
||||
- **Flexible File Filtering**: Match files using flexible presets (`*`, `cmd/*`, or specific file paths).
|
||||
- **Gitignore Smart Filtering**: Automatically skips files and directories specified in your `.gitignore` (e.g., `.git`, `node_modules`, `.DS_Store`).
|
||||
- **Clipboard Integration**: Directly copies the generated prompt to your clipboard—no manual file saving required.
|
||||
- **Customizable Templates**: Define how your code blocks are presented to the LLM via a YAML configuration file.
|
||||
|
||||
## Installation
|
||||
|
||||
Ensure you have [Go](https://go.dev/) installed (version 1.26 or higher), then clone the repository and run:
|
||||
|
||||
```bash
|
||||
chmod +x install.sh
|
||||
./install.sh
|
||||
```
|
||||
|
||||
This will compile and install the `cliprepo` binary into your `$GOPATH/bin` directory.
|
||||
|
||||
## Configuration
|
||||
|
||||
Create a `.cliprepo.yaml` file in the root of your project to manage path modes, custom prompt templates, and file group presets:
|
||||
|
||||
```yaml
|
||||
config:
|
||||
path_mode: relative # Options: 'relative' or 'absolute'
|
||||
|
||||
prompts:
|
||||
preset: "The following code is from file {{path}}:\n---\n{{content}}"
|
||||
|
||||
preset:
|
||||
all:
|
||||
- "*" # Scans and includes all tracked files in the repo
|
||||
|
||||
internal:
|
||||
- "internal/tree/*"
|
||||
- "internal/resolver/resolver.go"
|
||||
|
||||
cmd:
|
||||
- "cmd/*"
|
||||
```
|
||||
|
||||
## Usage
|
||||
|
||||
Run the tool using the `run` command by specifying a preset key defined in your `.cliprepo.yaml`.
|
||||
|
||||
### Print to Terminal
|
||||
|
||||
```bash
|
||||
cliprepo run --delineate cmd
|
||||
```
|
||||
|
||||
### Copy Directly to Clipboard
|
||||
|
||||
```bash
|
||||
cliprepo run --delineate all --clipboard
|
||||
```
|
||||
|
||||
### Flags
|
||||
|
||||
* `--delineate` (string): The preset key to use from `.cliprepo.yaml` (Required).
|
||||
* `--clipboard` (bool): Copy the output directly to your system clipboard instead of printing it to stdout.
|
||||
|
||||
## Output Example
|
||||
|
||||
When running `cliprepo run --delineate cmd`, the output format will look like this:
|
||||
|
||||
```text
|
||||
.
|
||||
├── cmd
|
||||
│ ├── root.go
|
||||
│ └── run.go
|
||||
└── main.go
|
||||
|
||||
The following code is from file cmd/root.go:
|
||||
---
|
||||
package cmd
|
||||
...
|
||||
|
||||
The following code is from file cmd/run.go:
|
||||
---
|
||||
package cmd
|
||||
...
|
||||
```
|
||||
|
||||
## License
|
||||
|
||||
[MIT License](https://www.google.com/search?q=LICENSE)
|
||||
|
||||
|
||||
@@ -0,0 +1,92 @@
|
||||
# cliprepo
|
||||
|
||||
`cliprepo` 是一个用 Go 语言编写的轻量、高效的命令行工具(CLI)。它可以将你代码库的目录结构和指定的文件内容一键打包成格式化的 Markdown 文本,专门用于快速为大语言模型(如 GPT、Claude、DeepSeek)构建完整的上下文。
|
||||
|
||||
## 功能特性
|
||||
|
||||
- **目录树生成**:自动生成清晰的 ASCII 目录树,并且会自动遵循 `.gitignore` 的过滤规则。
|
||||
- **灵活的文件过滤**:支持通过预设组合(Preset)匹配文件(如 `*`、`cmd/*` 或具体文件路径)。
|
||||
- **智能 Gitignore 过滤**:自动跳过 `.gitignore` 中指定的文件和文件夹(例如 `.git`、`node_modules`、`.DS_Store`)。
|
||||
- **剪贴板集成**:一键将生成的 Prompt 复制到系统剪贴板,省去手动复制或保存文件的烦恼。
|
||||
- **自定义模板**:支持通过 YAML 配置文件自定义代码块向 LLM 展示的模板。
|
||||
|
||||
## 安装指南
|
||||
|
||||
请确保你已经安装了 [Go](https://go.dev/)(版本 1.26 或更高),然后克隆本仓库并执行:
|
||||
|
||||
```bash
|
||||
chmod +x install.sh
|
||||
./install.sh
|
||||
```
|
||||
|
||||
这将会把编译好的 `cliprepo` 二进制文件安装到你的 `$GOPATH/bin` 目录下。
|
||||
|
||||
## 配置文件
|
||||
|
||||
在项目根目录下创建一个 `.cliprepo.yaml` 文件,用于管理路径模式、自定义提示词模板和文件组预设:
|
||||
|
||||
```yaml
|
||||
config:
|
||||
path_mode: relative # 可选值: 'relative' (相对路径) 或 'absolute' (绝对路径)
|
||||
|
||||
prompts:
|
||||
preset: "下面的代码来自文件 {{path}}:\n---\n{{content}}"
|
||||
|
||||
preset:
|
||||
all:
|
||||
- "*" # 扫描并包含库中所有未被 ignore 的文件
|
||||
|
||||
internal:
|
||||
- "internal/tree/*"
|
||||
- "internal/resolver/resolver.go"
|
||||
|
||||
cmd:
|
||||
- "cmd/*"
|
||||
```
|
||||
|
||||
## 使用方法
|
||||
|
||||
通过 `run` 命令并指定 `.cliprepo.yaml` 中配置的预设(preset)键名来运行该工具。
|
||||
|
||||
### 输出到终端屏幕
|
||||
|
||||
```bash
|
||||
cliprepo run --delineate cmd
|
||||
```
|
||||
|
||||
### 直接复制到剪贴板
|
||||
|
||||
```bash
|
||||
cliprepo run --delineate all --clipboard
|
||||
```
|
||||
|
||||
### 命令行参数(Flags)
|
||||
|
||||
* `--delineate` (string): 指定要使用的 `.cliprepo.yaml` 中的预设键名(必填)。
|
||||
* `--clipboard` (bool): 将生成的结果直接复制到系统剪贴板,不再在终端打印。
|
||||
|
||||
## 输出示例
|
||||
|
||||
当你运行 `cliprepo run --delineate cmd` 时,输出的内容格式如下:
|
||||
|
||||
```text
|
||||
.
|
||||
├── cmd
|
||||
│ ├── root.go
|
||||
│ └── run.go
|
||||
└── main.go
|
||||
|
||||
下面的代码来自文件 cmd/root.go:
|
||||
---
|
||||
package cmd
|
||||
...
|
||||
|
||||
下面的代码来自文件 cmd/run.go:
|
||||
---
|
||||
package cmd
|
||||
...
|
||||
```
|
||||
|
||||
## 开源协议
|
||||
|
||||
[MIT License](https://www.google.com/search?q=LICENSE)
|
||||
@@ -1,9 +0,0 @@
|
||||
package cmd
|
||||
|
||||
import (
|
||||
"github.com/atotto/clipboard"
|
||||
)
|
||||
|
||||
func copyToClipboard(content string) error {
|
||||
return clipboard.WriteAll(content)
|
||||
}
|
||||
+18
-17
@@ -4,14 +4,15 @@ import (
|
||||
"fmt"
|
||||
"os"
|
||||
"path/filepath"
|
||||
"sort"
|
||||
"strings"
|
||||
|
||||
"cliprepo/internal/config"
|
||||
"cliprepo/internal/resolver"
|
||||
"cliprepo/internal/tree"
|
||||
"cliprepo/internal/utils"
|
||||
|
||||
"github.com/spf13/cobra"
|
||||
"github.com/atotto/clipboard"
|
||||
"github.com/spf13/cobra"
|
||||
)
|
||||
|
||||
var delineate string
|
||||
@@ -28,50 +29,49 @@ var runCmd = &cobra.Command{
|
||||
return err
|
||||
}
|
||||
|
||||
// 1. tree
|
||||
treeStr, err := tree.Generate(".")
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
|
||||
var builder strings.Builder
|
||||
|
||||
// builder.WriteString("===== PROJECT TREE =====\n")
|
||||
builder.WriteString(treeStr)
|
||||
builder.WriteString("\n\n")
|
||||
|
||||
// 2. preset files
|
||||
var patterns []string
|
||||
r := resolver.New(".")
|
||||
|
||||
raw, ok := cfg.Preset[delineate]
|
||||
if !ok {
|
||||
return fmt.Errorf("preset not found: %s", delineate)
|
||||
}
|
||||
|
||||
patterns = append(patterns, raw...)
|
||||
patterns := []string(raw)
|
||||
var files []string
|
||||
|
||||
files, err := utils.ExpandGlob(patterns)
|
||||
if err != nil {
|
||||
return err
|
||||
for _, pattern := range patterns {
|
||||
matches, err := r.ResolvePattern(pattern)
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
files = append(files, matches...)
|
||||
}
|
||||
|
||||
// 3. template
|
||||
template := cfg.Prompts.Preset
|
||||
files = r.Unique(files)
|
||||
sort.Strings(files)
|
||||
|
||||
for _, file := range files {
|
||||
|
||||
content, err := os.ReadFile(file)
|
||||
if err != nil {
|
||||
continue
|
||||
}
|
||||
|
||||
path := file
|
||||
filePath := file
|
||||
if cfg.Config.PathMode == "absolute" {
|
||||
abs, _ := filepath.Abs(file)
|
||||
path = abs
|
||||
filePath = abs
|
||||
}
|
||||
|
||||
block := strings.ReplaceAll(template, "{{path}}", path)
|
||||
block := strings.ReplaceAll(template, "{{path}}", filePath)
|
||||
block = strings.ReplaceAll(block, "{{content}}", string(content))
|
||||
|
||||
builder.WriteString(block)
|
||||
@@ -80,6 +80,7 @@ var runCmd = &cobra.Command{
|
||||
|
||||
result := builder.String()
|
||||
|
||||
// 6. output
|
||||
if useClipboard {
|
||||
return clipboard.WriteAll(result)
|
||||
}
|
||||
|
||||
@@ -0,0 +1,132 @@
|
||||
package resolver
|
||||
|
||||
import (
|
||||
"cliprepo/internal/tree"
|
||||
"os"
|
||||
"path/filepath"
|
||||
)
|
||||
|
||||
type Resolver struct {
|
||||
root string
|
||||
seen map[string]struct{}
|
||||
}
|
||||
|
||||
func New(root string) *Resolver {
|
||||
return &Resolver{
|
||||
root: root,
|
||||
seen: make(map[string]struct{}),
|
||||
}
|
||||
}
|
||||
|
||||
// ResolvePattern 智能解析各种 pattern 并过滤 ignore 文件
|
||||
func (r *Resolver) ResolvePattern(pattern string) ([]string, error) {
|
||||
if pattern == "*" {
|
||||
return r.WalkAll()
|
||||
}
|
||||
|
||||
var matches []string
|
||||
// 处理类似 cmd/* 或 internal/tree/* 的情况
|
||||
// 如果包含 * 且不是以 ** 开头,转换为通过 filepath.Walk 匹配或直接 Glob 过滤
|
||||
rawMatches, err := filepath.Glob(pattern)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
|
||||
ig, _ := tree.Load(r.root)
|
||||
|
||||
for _, m := range rawMatches {
|
||||
info, err := os.Stat(m)
|
||||
if err != nil {
|
||||
continue
|
||||
}
|
||||
|
||||
rel, _ := filepath.Rel(r.root, m)
|
||||
// 统一检查 .gitignore
|
||||
if ig != nil && ig.MatchesPath(rel) {
|
||||
continue
|
||||
}
|
||||
|
||||
if info.IsDir() {
|
||||
// 如果匹配到的是目录(比如 internal/* 匹配到了 internal/config),则深层遍历该目录
|
||||
err := filepath.Walk(m, func(path string, fInfo os.FileInfo, walkErr error) error {
|
||||
if walkErr != nil || fInfo.IsDir() {
|
||||
return nil
|
||||
}
|
||||
fRel, _ := filepath.Rel(r.root, path)
|
||||
if ig != nil && ig.MatchesPath(fRel) {
|
||||
return nil
|
||||
}
|
||||
r.add(fRel, &matches)
|
||||
return nil
|
||||
})
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
} else {
|
||||
r.add(rel, &matches)
|
||||
}
|
||||
}
|
||||
|
||||
return matches, nil
|
||||
}
|
||||
|
||||
// WalkAll 遍历全库并过滤
|
||||
func (r *Resolver) WalkAll() ([]string, error) {
|
||||
var result []string
|
||||
ig, _ := tree.Load(r.root)
|
||||
|
||||
err := filepath.Walk(r.root, func(path string, info os.FileInfo, err error) error {
|
||||
if err != nil {
|
||||
return nil
|
||||
}
|
||||
|
||||
if info.IsDir() && info.Name() == ".git" {
|
||||
return filepath.SkipDir
|
||||
}
|
||||
|
||||
rel, _ := filepath.Rel(r.root, path)
|
||||
|
||||
if ig != nil && ig.MatchesPath(rel) {
|
||||
if info.IsDir() {
|
||||
return filepath.SkipDir
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
if info.IsDir() {
|
||||
return nil
|
||||
}
|
||||
|
||||
r.add(rel, &result)
|
||||
return nil
|
||||
})
|
||||
|
||||
return result, err
|
||||
}
|
||||
|
||||
func (r *Resolver) AddFile(path string, result *[]string) {
|
||||
r.add(path, result)
|
||||
}
|
||||
|
||||
func (r *Resolver) add(path string, result *[]string) {
|
||||
if _, ok := r.seen[path]; ok {
|
||||
return
|
||||
}
|
||||
r.seen[path] = struct{}{}
|
||||
*result = append(*result, path)
|
||||
}
|
||||
|
||||
func (r *Resolver) Unique(in []string) []string {
|
||||
seen := make(map[string]struct{})
|
||||
out := make([]string, 0, len(in))
|
||||
|
||||
for _, f := range in {
|
||||
if _, ok := seen[f]; ok {
|
||||
continue
|
||||
}
|
||||
seen[f] = struct{}{}
|
||||
out = append(out, f)
|
||||
}
|
||||
|
||||
return out
|
||||
}
|
||||
@@ -1,27 +0,0 @@
|
||||
package utils
|
||||
|
||||
import (
|
||||
"os"
|
||||
"path/filepath"
|
||||
)
|
||||
|
||||
func ExpandPaths(patterns []string) ([]string, error) {
|
||||
var result []string
|
||||
|
||||
for _, pattern := range patterns {
|
||||
matches, err := filepath.Glob(pattern)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
|
||||
for _, m := range matches {
|
||||
info, err := os.Stat(m)
|
||||
if err != nil || info.IsDir() {
|
||||
continue
|
||||
}
|
||||
result = append(result, m)
|
||||
}
|
||||
}
|
||||
|
||||
return result, nil
|
||||
}
|
||||
@@ -1,78 +0,0 @@
|
||||
package utils
|
||||
|
||||
import (
|
||||
"os"
|
||||
"path/filepath"
|
||||
"strings"
|
||||
)
|
||||
|
||||
func ExpandGlob(patterns []string) ([]string, error) {
|
||||
var result []string
|
||||
seen := make(map[string]struct{})
|
||||
|
||||
for _, pattern := range patterns {
|
||||
|
||||
if pattern == "*" {
|
||||
filepath.Walk(".", func(path string, info os.FileInfo, err error) error {
|
||||
if err != nil {
|
||||
return nil
|
||||
}
|
||||
if info.IsDir() {
|
||||
return nil
|
||||
}
|
||||
add(path, seen, &result)
|
||||
return nil
|
||||
})
|
||||
continue
|
||||
}
|
||||
|
||||
isRecursive := strings.Contains(pattern, "**")
|
||||
|
||||
if isRecursive {
|
||||
root := strings.Split(pattern, "**")[0]
|
||||
if root == "" {
|
||||
root = "."
|
||||
}
|
||||
|
||||
filepath.Walk(root, func(path string, info os.FileInfo, err error) error {
|
||||
if err != nil || info.IsDir() {
|
||||
return nil
|
||||
}
|
||||
|
||||
matched, _ := filepath.Match(
|
||||
strings.Replace(pattern, "**", "*", 1),
|
||||
path,
|
||||
)
|
||||
|
||||
if matched {
|
||||
add(path, seen, &result)
|
||||
}
|
||||
return nil
|
||||
})
|
||||
continue
|
||||
}
|
||||
|
||||
matches, err := filepath.Glob(pattern)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
|
||||
for _, m := range matches {
|
||||
info, err := os.Stat(m)
|
||||
if err != nil || info.IsDir() {
|
||||
continue
|
||||
}
|
||||
add(m, seen, &result)
|
||||
}
|
||||
}
|
||||
|
||||
return result, nil
|
||||
}
|
||||
|
||||
func add(path string, seen map[string]struct{}, result *[]string) {
|
||||
if _, ok := seen[path]; ok {
|
||||
return
|
||||
}
|
||||
seen[path] = struct{}{}
|
||||
*result = append(*result, path)
|
||||
}
|
||||
Reference in New Issue
Block a user