🤖 aictx is a powerful CLI tool that transforms your entire codebase into a single, AI-ready text file. Perfect for feeding context to large language models like ChatGPT, Claude, and more, it supports both local directories and remote Git repositories. With flexible filtering options—including global and mode-specific include/exclude patterns—you control exactly which files are included, creating a seamless narrative of your project.
-
📁 Local Directory Support: Processes given local directory and its subdirectories (if needed, including hidden content as well).
-
🌐 Git Repository Support: Accepts a Git repository shorthand (e.g.,
github.com/amberpixels/aictx) to process its codebase. -
🗃️ Tree Mode: Displays a structured tree view of the input with a summary (total file count, cumulative size, and largest file size).
-
📜 Source Mode: Outputs the contents of allowed source files with informative headers including file number and size. Files exceeding a configurable size threshold are skipped.
-
🛠️ Flexible Filtering:
- Apply global and mode-specific glob patterns (supports comma-separated lists) to include or exclude files.
- Automatically respects
.gitignoreif exists (can be disabled). - Automatically ignores common unwanted files (e.g.,
vendor,Thumbs.db,__pycache__,node_modules) (can be disabled). - Automatically ignores hidden and/or binary files (can be disabled).
- Reads additional ignore patterns from a
.aictxignorefile in the input directory. - Automatically excludes the output file (default
output.txtor a user-specified file) from processing.
Ensure you have Go installed.
go install github.com/amberpixels/aictx@latestUsage: aictx [<input-path>] [flags]
Arguments:
[<input-path>] Input directory (or git repo URL) to process
Flags:
-h, --help Show context-sensitive help.
-l, --local Treat inputPath arg as a local directory.
If inputPath is '.' it is automatically makes
local=true.
-i, --include="" Global include glob pattern (supports
comma-separated list)
-x, --exclude="" Global exclude glob pattern (supports
comma-separated list)
--source.disabled Disable source mode
--source.include="" Include glob pattern specific for source mode.
Global include is used if not specified.
--source.exclude="" Exclude glob pattern specific for source mode.
Global exclude is used if not specified.
--source.threshold=0.1 Exclude sources for files >= threshold (Mb)
--source.show-hidden Show hidden files in source mode
--tree.disabled Disable tree mode
--tree.include=""
7C48
Include glob pattern specific for tree mode.
Global include is used if not specified.
--tree.exclude="" Exclude glob pattern specific for tree mode.
Global exclude is used if not specified.
--tree.show-hidden Show hidden files in tree mode
-o, --out="output.txt" Output destination file ("stdout" for stdout)
-v, --verbose Verbose mode
-r, --raw Concatenate file contents in raw mode without
headers or summary
-L, --list-core-ignores List core ignore patterns and exit
--no-core-ignores Disable core ignore patterns
--no-git-ignore Disable respecting .gitignore file
-
Display Both Tree and Source views for a Current Local Directory
aictx
-
Display Both Tree and Source views for a Github repo
aictx amberpixels/aictx # supported any type of github repo mention. # as well as gitlab's repos. aictx github.com/amberpixels/aictx
-
**Include specific globs (for both Tree & Source mode) **
aictx --i "*.go,go.md" -
Process a Git Repository with a Custom Size Threshold
aictx github.com/amberpixels/aictx --source.threshold 0.2 --source.include="*.js" --out=stdout -
List Core Ignore Patterns
aictx --list-core-ignores
-
Include everything: hidden files (and core-ignored)
aictx --no-core-ignores --show-hidden
Project Tree [9 files, 16.05 MB total, max 16.01 MB] (* - for binary files)
.
├── build
│ └── aictx *
├── cmd
│ └── aictx
│ └── main.go
├── internal
│ ├── aictx
│ │ ├── app.go
│ │ ├── core_ignores.go
│ │ ├── git.go
│ │ ├── git_test.go
│ │ └── helpers.go
│ └── fsutils
│ └── fsutils.go
└── tools
└── readmegen.go
Contributions are welcome! Please fork the repository and submit pull requests for any enhancements, bug fixes, or suggestions.
Please Note: The application is stable and ready-to-be used, but it is not currently covered by tests. As a result, accepting new features may take longer than expected until we have at least some basic test coverage in place. We appreciate your patience and contributions as we work towards enhancing the project's quality and reliability.
This project is licensed under the MIT License.
Happy coding! ❤️