✔ Copied to clipboard
v3.2.1  ·  MIT License  ·  Python 3.10+

Map your codebase.
Feed AI only
what it needs.

AITree generates an annotated file tree in one command. Paste it into any AI chat — let the AI ask for exactly the files it needs. Stop uploading everything.

Works with
Claude
Cursor
GPT-4
Gemini
any AI chat
bash — ~/projects/webapp
How it works

Three steps. That's the entire workflow.

Stop the copy-paste nightmare of sharing files one by one. Map first, share precisely.

01
Run one command.
Generate your entire project map and copy it to the clipboard in one shot.
$ aitree . --copy
#
# 4 dirs, 18 files (142KB)
✔ Copied to clipboard
02
Paste the map.
Share the structure — not your source code. Let the AI understand your project layout first.
You: Here's my project map.
Which files do you need?

AI: Please share
src/auth/login.py
and models/user.py
03
Send only what's needed.
The AI works with surgical precision. No noise, no wasted tokens, faster and better answers.
$ cat src/auth/login.py
→ 2 files · 3.2KB total
→ not the whole codebase
→ AI answers precisely ✦
Features

Everything a developer needs.

From quick clipboard copy to full MCP server integration — AITree fits into any AI workflow.

Multiple Output Formats
Plain text for pasting, JSON for tooling, Markdown for docs. Pick what your workflow needs.
--format text | json | markdown
GitHub URL Support
Scan any public or private GitHub repository without cloning. Works entirely via the GitHub API.
aitree https://github.com/owner/repo
Interactive Web UI
Full browser explorer: collapsible tree, file preview with syntax highlighting, search, and live reload.
aitree . --serve
Claude · Cursor
MCP Server
Native AI assistant integration. Let Claude Desktop or Cursor read and navigate your file tree directly as a tool.
aitree-mcp
Live Watch Mode
Watches your project in real time. Filters false positives with content hashing and 1-second debounce.
aitree . --live
Smart Filtering
Depth limits, glob include/exclude patterns, git-changed-only mode. Respects .gitignore and .aitreeignore automatically.
--depth 2 --include "*.py" --git-changed
MCP Integration

First-class AI assistant support.

AITree ships an MCP server. Claude Desktop and Cursor can call it as a native tool — no shell, no copy-paste, no context switching.

Four tools. Full access.
The MCP server exposes your project as a structured, queryable API. The AI navigates it like a filesystem — reading only what it needs.
aitree_get_tree
Full project structure for any local path or GitHub URL
aitree_read_file
Read any file's contents on demand — without leaving the conversation
aitree_get_stats
Structured JSON codebase statistics by extension, size, and token count
aitree_get_changed
List git-changed and untracked files in the current repository
Setup in 30 seconds
Install the MCP dependency, add one config block, and Claude Desktop is ready.
claude_desktop_config.json 
{
  "mcpServers": {
    "aitree": {
      "command": "aitree-mcp"
    }
  }
}
Install MCP dependency first
$ pip install "paracci-aitree[mcp]"
Get started

Up and running in seconds.

No configuration required. Works on every platform. Python 3.10+ is all you need.

$ pip install paracci-aitree
Click to copy
Optional extras — install only what you need
live
tokens
git
mcp
all
$ pip install "paracci-aitree[live]"
Quick start
$ aitree .
print tree to stdout
$ aitree . --copy
copy to clipboard
$ aitree . --serve
open web UI in browser
$ aitree . --live
watch for changes
$ aitree https://github.com/owner/repo
scan GitHub repo
Linux
macOS
Windows
WSL