toai

toai is a tiny Rust CLI that dumps a folder into an AI-friendly text format.
Each file is printed with its relative path header, followed by its contents.
Example of the output format:

src/main.tsx

-- file content here --

package.json

-- file content here --

By default, toai skips heavy folders (node_modules, target, .git, …) and common binary/cache files via glob patterns.

Install

From source:

1. git clone https://github.com/devmaxde/toai.git
2. cd toai
3. cargo install --path .

or

1. cargo install toai

Usage

toai [OPTIONS]

Common examples:

1. Dump current directory to a file
   toai --path . --output output.txt

2. Dump a specific folder
   toai --path ./my-project --output ./dump.txt

3. Print to stdout (no file)
   toai --path .

4. Add custom ignores (repeatable, supports globs)
   toai --path . --output out.txt --ignore somefolder --ignore ".png" --ignore ".log"

5. Disable default ignores and specify your own
   toai --path . --output out.txt --no-ignore-default --ignore build --ignore cache --ignore "*.o"

6. Ensure the output file isn’t included (handled automatically if it’s inside the scanned tree)
   toai --path . --output ./dump/project.txt

Options

--path
Root directory to scan (default: .)

--output
Write output to a file instead of stdout

--ignore
Ignore entries matching a pattern. Supports globs like .png, **/dist, cmake-build-
Can be provided multiple times

--no-ignore-default
Disable the default ignore set

Default ignore set

Applied unless --no-ignore-default is used.

Directories
nodemodules
target
dist
build
.next
.turbo
.git
.idea
.vscode
pycache
.pytest_cache
.mypy_cache
.ruff_cache
CMakeFiles
cmake-build-
Pods
buck-out
bazel-_

Files
Cargo.lock
LICENSE
.DS_Store

Binary and cache extensions
Python: _.pyc, _.pyo, _.pyd
C/C++/Rust: _.o, _.obj, _.so, _.dll, _.dylib, _.exe, _.out, _.a, _.lib
Logs/Temp: _.log, _.tmp, _.swp
Images: _.png, _.jpg, _.jpeg, _.gif, _.bmp, _.tiff, _.ico, _.svg, _.webp, _.heic, _.heif
3D assets: _.vrm, _.fbx, _.glb, _.gltf, _.blend, _.obj, _.stl
Archives: _.zip, _.tar, _.gz, _.bz2, _.xz, _.7z, _.rar