ctxgen 0.2.2

Generate AGENTS.md and CLAUDE.md from .context folder
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

# ctxgen

A Rust CLI tool that generates `AGENTS.md` and `CLAUDE.md` files from a `.context` folder.

## Overview

`ctxgen` reads text files from a `.context` directory (typically at the root of a code repository) and compiles them into markdown files suitable for AI agents. The tool:

- Flattens nested folder structures into a single output file
- Wraps each file's contents in `<file>` tags with path information
- Supports fold tags to hide content that agents should read from the source

## Installation

See [latest release](https://github.com/AndrewHannigan/ctxgen/releases) for installation steps.

## Usage

```bash
# Basic usage (uses .context in current directory)
ctxgen

# Specify a custom context directory
ctxgen --context-dir /path/to/.context

# Specify output directory
ctxgen --output-dir /path/to/output

# Full options
ctxgen -c .context -o .
```

## Context Folder Structure

The `.context` folder can contain text files organized in any folder structure. Here's an example:

```
.context/
├── guidelines.txt
├── architecture/
│   ├── overview.txt
│   └── patterns.txt
└── api/
    └── conventions.txt
```

## Output Format

Each file is wrapped in a `<file>` tag:

```xml
<file path="guidelines.txt">
Content of the file...
</file>

<file path="architecture/overview.txt">
Content of nested file...
</file>
```

## Fold Tags

Use `<ctxgen:fold>` tags to hide content in the generated markdown. This is useful for controlling context bloat. Agent can read the folded content using filesystem tools:

```xml
This content is always visible.

<ctxgen:fold>
This detailed content will be replaced with a placeholder.
The agent will be instructed to read the original file to see it.
</ctxgen:fold>

More visible content here.
```

When compiled, the fold is replaced with a placeholder:

```
This content is always visible.

[Folded content: 2 lines (lines 3-4). Read 'filename.txt' for full content.]

More visible content here.
```

Files containing folds will have `has_folds="true"` added to their `<file>` tag:

```xml
<file path="detailed-guide.txt" has_folds="true">
...
</file>
```

## Options

| Option | Short | Default | Description |
|--------|-------|---------|-------------|
| `--context-dir` | `-c` | `.context` | Path to the context folder |
| `--output-dir` | `-o` | `.` | Output directory for generated files |

## License

MIT