Fileofy NPM | npm.io

Fileofy

A TypeScript library that uses Google's Gemini AI to interpret text instructions and perform file modifications. The library can create, update, or delete files based on natural language input.

Features

🤖 Powered by Google's Gemini AI
📝 Create, update, or delete files using natural language
🎯 Precise line-based modifications
🔒 Type-safe with TypeScript
🌟 Simple, promise-based API

Installation

npm install fileofy

Setup

Get a Gemini API key from Google AI Studio
Create a .env file in your project root:

GEMINI_API_KEY=your_api_key_here

Usage

import { applyFileModification } from 'fileofy';

// Example: Create a new file
await applyFileModification('Create a new file called hello.txt with the content "Hello, World!"');

// Example: Update existing file
await applyFileModification('In main.ts, replace lines 5-10 with a console.log statement');

// Example: Delete file
await applyFileModification('Delete the temporary.txt file');

File Modification Schema

The library uses a structured schema for file modifications:

{
  filePath: string;    // Path to the file to modify
  operation: "create" | "update" | "delete";  // Type of operation
  content: string;     // Content for create/update operations
  startLine: number;   // Starting line (1-based, always 1 for create, -1 for last line)
  endLine: number;     // Ending line (1-based, -1 for last line)
}