Getting started
How to use RepoTree to generate and export repository trees.
Basic usage
1
Enter a repository URL
Paste any public GitHub or GitLab repository URL into the input field. The provider is auto-detected from the URL.
2
Click Generate
RepoTree fetches the repository structure via the GitHub or GitLab API and builds your ASCII tree.
3
Customize the output
Use the Settings icon to adjust ASCII style, enable icons, line numbers, descriptions, or trailing slashes.
4
Export or copy
Copy to clipboard or download as .md, .txt, .json, or .html — ready to paste into your README.
Private repositories
GitHub
- 1. Click Sign in in the header
- 2. Choose Continue with GitHub
- 3. Authorize the required permissions (
read:user repo) - 4. You can now generate trees from your private repositories
GitLab
- 1. Click Sign in in the header
- 2. Choose Continue with GitLab
- 3. Authorize the required permissions (
read_user read_repository) - 4. You can now generate trees from your private repositories
Your OAuth access token is stored in an encrypted session cookie — never in localStorage or exposed to client-side code. Sessions expire after 24 hours.
API rate limits
| Provider | Unauthenticated | Signed in |
|---|---|---|
| GitHub | 60 req/hr | 5,000 req/hr |
| GitLab | Varies | Higher limits |