antinomyhq / forge

⚒️ Forge: AI-Enhanced Terminal Development Environment A comprehensive coding agent that integrates AI capabilities with your development environment curl -fsSL https://forgecode.dev/cli | sh --- Table of Contents • Quickstart • Usage Examples • Why Forge? • Command-Line Options • Advanced Configuration • Provider Configuration • Managing Provider Credentials • Deprecated: Environment Variables • forge.yaml Configuration Options • Environment Variables • MCP Configuration • Example Use Cases • Usage in Multi-Agent Workflows • Documentation • Community • Support Us --- Quickstart To get started with Forge, run the command below: On first run, Forge will guide you through setting up your AI provider credentials using the interactive login flow. Alternatively, you can configure providers beforehand: That's it! Forge is now ready to assist you with your development tasks. Usage Examples Forge can be used in different ways depending on your needs. Here are some common usage patterns: Code Understanding Forge will analyze your project's structure, identify authentication-related files, and provide a detailed explanation of the authentication flow, including the relationships between different components. Implementing New Features Forge will suggest the best approach based on your current codebase, explain the steps needed, and even scaffold the necessary components and styles for you. Debugging Assistance Forge will analyze the error, suggest potential causes based on your code, and propose different solutions to fix the issue. Code Reviews Forge will analyze the code, identify potential issues, and suggest improvements for readability, performance, security, and maintainability. Learning New Technologies Forge will provide a tailored tutorial on integrating GraphQL with Express, using your specific project structure as context. Database Schema Design Forge will suggest an appropriate schema design, including tables/collections, relationships, indexes, and constraints based on your project's existing database technology. Refactoring Legacy Code Forge can help modernize your codebase by walking you through refactoring steps and implementing them with your approval. Git Operations Forge can guide you through resolving git conflicts, explaining the differences and suggesting the best way to reconcile them. Why Forge? Forge is designed for developers who want to enhance their workflow with AI assistance while maintaining full control over their development environment. • **Zero configuration** - Just add your API key and you're ready to go • **Seamless integration** - Works right in your terminal, where you already work • **Multi-provider support** - Use OpenAI, Anthropic, or other LLM providers • **Secure by design** - Restricted shell mode limits file system access and prevents unintended changes • **Open-source** - Transparent, extensible, and community-driven Forge helps you code faster, solve complex problems, and learn new technologies without leaving your terminal. Command-Line Options Here's a quick reference of Forge's command-line options: | Option | Description | | ------------------------------- | ---------------------------------------------------------- | | | Direct prompt to process without entering interactive mode | | | Path to a file containing initial commands to execute | | | Path to a file containing the workflow to execute | | | Dispatch an event to the workflow | | | Path to a file containing the conversation to execute | | | Enable restricted shell mode for enhanced security | | | Enable verbose output mode | | | Print help information | | | Print version | Advanced Configuration Provider Configuration Forge supports multiple AI providers. The recommended way to configure providers is using the interactive login command: This will: • Show you a list of available providers • Guide you through entering the required credentials Managing Provider Credentials Deprecated: Environment Variables > **⚠️ DEPRECATED**: Using files for provider configuration is deprecated and will be removed in a future version. Please use instead. For backward compatibility, Forge still supports environment variables. On first run, any credentials found in environment variables will be automatically migrated to file-based storage. Legacy Environment Variable Setup (Deprecated) OpenRouter Requesty x-ai z.ai Cerebras IO Intelligence OpenAI Anthropic Google Vertex AI **Setup Instructions:** • **Install Google Cloud CLI** and authenticate: • **Get your authentication token**: • **Use the token when logging in via Forge**: **Legacy setup:** **Available Models:** • Claude models: • Gemini models: , Use the command in Forge CLI to see all available models. OpenAI-Compatible Providers Groq Amazon Bedrock To use Amazon Bedrock models with Forge, you'll need to first set up the Bedrock Access Gateway: • **Set up Bedrock Access Gateway**: • Follow the deployment steps in the Bedrock Access Gateway repo • Create your own API key in Secrets Manager • Deploy the CloudFormation stack • Note your API Base URL from the CloudFormation outputs • **Configure in Forge**: **Legacy setup:** ForgeCode Services --- forge.yaml Configuration Options Environment Variables Forge supports several environment variables for advanced configuration and fine-tuning. These can be set in your file or system environment. Retry Configuration Control how Forge handles retry logic for failed requests: HTTP Configuration Fine-tune HTTP client behavior for API requests: > **⚠️ Security Warning**: Setting disables SSL/TLS certificate verification, which can expose you to man-in-the-middle attacks. Only use this in development environments or when you fully trust the network and endpoints. API Configuration Override default API endpoints and provider/model settings: Tool Configuration Configuring the tool calls settings: ZSH Plugin C…