An open API service indexing awesome lists of open source software.

https://github.com/codingworkflow/ai-code-fusion

Desktop app to process repository content into one file
https://github.com/codingworkflow/ai-code-fusion

ai ai-tools chatgpt claude claude-ai electron llm

Last synced: 3 months ago
JSON representation

Desktop app to process repository content into one file

Awesome Lists containing this project

README

          

# AI Code Fusion

## Features

A desktop application for preparing and optimizing code repositories for AI processing and analysis. It helps you select specific files, count tokens, and process source code for AI systems.

- Visual directory explorer for selecting code files
- Advanced file filtering with customizable patterns
- Accurate token counting for various AI models
- Code content processing with statistics
- Cross-platform support (Windows, macOS, Linux)

## Installation

### Download

Download the latest version for your platform from the [Releases page](https://github.com/codingworkflow/ai-code-fusion/releases).

### Windows

1. Download the `.exe` installer
2. Run the installer and follow the instructions
3. Launch from the Start Menu or desktop shortcut

### macOS

1. Download the `.dmg` file
2. Open the DMG and drag the application to your Applications folder
3. Launch from Applications

### Linux

1. Download the `.AppImage` file
2. Make it executable: `chmod +x AI.Code.Prep-*.AppImage`
3. Run it: `./AI.Code.Prep-*.AppImage`

## Usage Guide

### 1. Start and Filters

The application now features both Dark and Light modes for improved user experience.
![Start Panel Dark Mode](assets/ai_code_fusion_1.jpg)

![Start Panel Light Mode](assets/ai_code_fusion_2.jpg)

Extended file filtering options:

- Exclude specific file types and patterns (using glob patterns) to remove build folders, venv, node_modules, .git from tree view and file selection
- Automatically exclude files based on .gitignore files in your repository
- Reduce selection to only the file extensions you specify
- Display token count in real-time during selection (can be disabled for very large repositories)
- Include file tree in output (recommended for better context in AI models)

### 2. File Selection

Select specific files and directories to analyze and process.

![Analysis Panel](assets/ai_code_fusion_3.jpg)

- Browse and select your root project directory
- Use the tree view to select specific files or folders
- See file counts and token sizes in real-time (when token display is enabled)

### 3. Final Processing

Generate the processed output ready for use with AI systems.

![Processing Panel](assets/ai_code_fusion_4.jpg)

- View the final processed content ready for AI systems
- Copy content directly to clipboard for immediate use
- Export to file for later reference
- Review files by token count to help identify large files you may want to exclude

## Building from Source

### Prerequisites

- Node.js (v14 or later)
- npm
- Git

### Setup

```bash
# Clone the repository
git clone https://github.com/codingworkflow/ai-code-fusion
cd ai-code-fusion

# Install dependencies
make setup
# or
npm install
```

### Development

```bash
# Start the development server
make dev
# or
npm run dev
```

#### Troubleshooting Development

If you encounter issues with the development server:

1. For Windows users: The `make.bat` file has special handling for the `dev` command that properly sets environment variables
2. If you're still having issues:
- Ensure all dependencies are installed: `npm install`
- Try rebuilding: `npm run rebuild`
- Close any running instances of the app
- Restart your terminal/command prompt
- As a last resort, try direct electron launch: `npm run dev:direct`

### Building

```bash
# Build for current platform
make build

# Build for specific platforms
make build-win # Windows
make build-linux # Linux
make build-mac # macOS (Intel)
make build-mac-arm # macOS (Apple Silicon)
make build-mac-universal # macOS (Universal)
```

## License

GPL 3.0