SyncFix — AI-Powered Vibe Coding Tool

SyncFix is a terminal-based AI coding assistant that lets you read, edit, create, delete, and manage files in your project using natural language. Powered by NVIDIA's OpenAI-compatible API.

Quick Start

# Install
npm install -g syncfix

# Initialize in your project
cd my-project
syncfix init

# Start vibe coding
syncfix chat

How It Works

SyncFix connects to any NVIDIA (or OpenAI-compatible) model and exposes the model's intelligence as file system operations. You chat in natural language, and SyncFix executes the changes via function calling:

syncfix> create a utility function that reads CSV files
syncfix> fix the bug in server.js on line 42
syncfix> refactor the auth module to use async/await
syncfix> show me all TypeScript files with TODO comments

Architecture

syncfix/
├── src/
│   ├── index.ts           # CLI entry point
│   ├── commands/
│   │   ├── init.ts        # syncfix init
│   │   ├── chat.ts        # syncfix chat
│   │   └── env.ts         # syncfix env
│   ├── config/
│   │   ├── schema.ts      # Configuration types
│   │   └── store.ts       # Config persistence (env > project > global)
│   ├── ai/
│   │   ├── client.ts      # OpenAI-compatible API client
│   │   └── tools.ts       # Function-calling tool definitions
│   ├── fs/
│   │   ├── operations.ts  # File read/write/edit/delete/search
│   │   └── permission.ts  # Permission & path validation
│   ├── env/
│   │   └── python.ts      # Python virtual environment management
│   ├── chat/
│   │   └── session.ts     # Interactive chat session
│   └── utils/
│       └── logger.ts      # Logging

Configuration (Layered)

Priority order: Environment variables > Project config > Global config > Defaults

| Variable | Description | Default | |----------|-------------|---------| | NVIDIA_API_KEY | NVIDIA API key | — | | SYNCFIX_MODEL | Model name | meta/llama-3.1-8b-instruct | | SYNCFIX_BASE_URL | API base URL | https://integrate.api.nvidia.com/v1 | | SYNCFIX_WORK_DIR | Working directory | . |

Commands

syncfix init

Interactive setup — configures API key, model selection, permissions, and Python venv.

syncfix chat

Starts an interactive vibe coding session. The AI can read, write, edit, delete files, run commands, and search code — all through natural language.

syncfix env

Manage the Python virtual environment:

syncfix env setup           # Create venv
syncfix env install numpy   # Install packages
syncfix env list            # List packages
syncfix env path            # Show venv paths
syncfix env run script.py   # Run a script

Security

• Deleting files is disabled by default — enable with allowDelete: true in config
• Shell command execution is disabled by default — enable with allowExecute: true
• System paths (.git, node_modules, env) are blocked from modification
• Dangerous shell commands (rm -rf, sudo, etc.) are blocked
• All operations are logged locally

Requirements

• Node.js 18+
• Python 3.8+ (optional, for Python environment features)
• NVIDIA API key (get one at https://build.nvidia.com)