Forge AI: Intelligent Coding Agent

An AI coding agent that can inspect, reason about, and modify your codebase through an interactive command-line interface. Forge AI empowers developers by automating code inspection, proposing changes with user approval, and understanding complex project structures.

✨ Key Features

• Interactive CLI: Engage with the AI agent directly from your terminal.
• Intelligent Code Modification: Agent can inspect, reason about, and propose code changes.
• Human-in-the-Loop: All code changes are presented as diffs for user review and approval.
• Multi-LLM Support: Configurable to use various LLM providers (OpenAI, Google Gemini, Anthropic).
• Conversation Memory: Persists chat history across sessions using SQLite.
• Project Structure Awareness: Agent builds a dynamic understanding of your project layout.
• Data & Notebook Inspection: Specialized tools for summarizing datasets and reading Jupyter Notebooks.
• Code Execution Capabilities: Can execute the code and analyze the outputs or errors.

🚀 Installation & Usage

Prerequisites

• Python 3.8+

Installation

Install from PyPI:

pip install forge-ai

Configuration

Before using Forge AI, you need to initialize it with your preferred LLM provider and API key.

forge init --provider <provider_name> --api-key <YOUR_API_KEY> [--model <model_name>]

Example:

• OpenAI:

  forge init --provider openai --api-key sk-xxxx --model gpt-4o-mini
  

• Google Gemini:

  forge init --provider gemini --api-key your-gemini-api-key --model gemini-2.5-flash
  

• Anthropic:

  forge init --provider anthropic --api-key your-anthropic-api-key --model claude-3-haiku-20240307
  

Forge AI will store your configuration in a .forge/config.json file in your current working directory.

Running the Agent

Simply run forge to start an interactive chat session with the AI agent:

forge

• Continue a Session: To pick up a previous conversation, use the --thread-id option (displayed when a new session starts).

  forge --thread-id <your_thread_id>
  

• Exit: Type exit or quit to end the chat session. You'll be prompted to clear memory or delete all Forge data.

CLI Commands

• forge init: Initialize Forge AI with your LLM provider and API key.

  forge init --provider openai --api-key YOUR_KEY
  

• forge clear_memory: Clears all conversation history from the SQLite database.

  forge clear_memory
  

• forge stop: Deletes the entire .forge directory, including configuration and all conversation memory. This is irreversible.

  forge stop
  

CHANGELOG

1.1.0 - 2025-09-16

• 🏗 Added notebook writing and code execution capabilites.

1.0.0 - 2025-09-14

• 🚀 Initial release