# forgecode | Forge Code | Knowledge Base | Instagit

AI enabled pair programmer for Claude, GPT, O Series, Grok, Deepseek, Gemini and 300+ models

GitHub Stars: 6.3k

Repository: https://github.com/antinomyhq/forgecode

---

## Articles

### [How the Forge Update Mechanism Works: Environment Variables and Auto-Update Configuration](/antinomyhq/forgecode/forge-update-mechanism-auto-update-environment-variables)

Discover how the Forge update mechanism works and the environment variables like FORGE_UPDATES__AUTO_UPDATE that control its silent and automatic installation of GitHub releases.

- Tags: internals
- Published: 2026-04-08

### [How the Forge Doctor Command Diagnoses Shell Environment Issues: A Complete Technical Guide](/antinomyhq/forgecode/forge-doctor-command-shell-environment-diagnostics)

Learn how the Forge doctor command diagnoses shell environment issues. It checks 9 critical areas like Zsh version and dependencies returning exit code 0 only when all checks pass.

- Tags: how-to-guide
- Published: 2026-04-08

### [fs_read vs fs_patch in Forge: When to Use Each File System Tool](/antinomyhq/forgecode/forge-fs_read-vs-fs_patch-tools-usage)

Understand fs_read vs fs_patch in Forge. Use fs_read for inspecting files and fs_patch for safe, validated edits with automatic snapshots. Learn which tool fits your needs.

- Tags: how-to-guide
- Published: 2026-04-08

### [How the Forge ZSH Theme Displays Cost Information: Environment Variable Configuration](/antinomyhq/forgecode/forge-zsh-theme-cost-display-currency-environment-variables)

Learn how the Forge ZSH theme shows session cost in your terminal. Discover environment variables for currency symbol and conversion rate in antinomyhq/forgecode.

- Tags: how-to-guide
- Published: 2026-04-08

### [How Tool Call Context Tracking Works in Forge: The Three-Stage Pipeline Explained](/antinomyhq/forgecode/forge-tool-call-context-tracking-result-feedback)

Learn how Forge tracks tool calls via a three-stage pipeline. Discover how tool results feed back to the model for seamless integration and enhanced AI functionality.

- Tags: deep-dive
- Published: 2026-04-08

### [Thread-Safe Architecture Using Arc<T> for Infrastructure Dependencies in Forge Services](/antinomyhq/forgecode/forge-thread-safe-architecture-arc-t-infrastructure-dependencies)

Learn how Forge services use Arc<T> to create thread-safe architecture for infrastructure dependencies. Achieve cheap cloning across async tasks avoiding mutable refs or complex synchronization.

- Tags: architecture
- Published: 2026-04-08

### [How Custom Commands Work in Forge: A Complete Guide to Prompt Shortcuts](/antinomyhq/forgecode/forge-custom-commands-shortcuts-repetitive-prompts)

Learn how custom commands in Forge work as reusable prompt templates. Define CLI shortcuts for repetitive prompts and streamline your workflow with this complete guide.

- Tags: how-to-guide
- Published: 2026-04-08

### [Provider Authentication Flow in Forge: OAuth Methods and Configuration Guide](/antinomyhq/forgecode/forge-provider-authentication-flow-oauth-configurations)

Master Forge provider authentication with our OAuth guide. Explore Initialize, Complete, and Refresh flows supporting API keys, ADC, device code, auth code, and Codex flows.

- Tags: how-to-guide
- Published: 2026-04-08

### [Forge Compact Configuration: Managing Context with Token Thresholds and Retention Windows](/antinomyhq/forgecode/forge-compact-configuration-token-retention-eviction-windows)

Learn how Forge compact configuration manages context using token_threshold, retention_window, and eviction_window. Optimize your AI's memory and performance.

- Tags: internals
- Published: 2026-04-08

### [How to Configure the HTTP Client and Custom TLS Settings in Forge](/antinomyhq/forgecode/forge-http-client-configuration-custom-tls)

Explore Forge's three-layer HTTP client architecture built on reqwest. Learn to configure HTTP client and custom TLS settings using code, TOML, or environment variables.

- Tags: how-to-guide
- Published: 2026-04-08

### [How to Configure Custom Skills in Forge: Project-Local vs Global Precedence Order](/antinomyhq/forgecode/forge-configure-custom-skills-precedence-order)

Learn how to configure custom skills in Forge. Discover the precedence order: project-local skills override global skills, which override built-in ones. Maximize your Forge workflows.

- Tags: how-to-guide
- Published: 2026-04-08

### [How the Forge File Walker Determines Which Files to Include in Context](/antinomyhq/forgecode/forge-file-walker-context-inclusion-max_walker_depth)

Learn how the Forge file walker selects files using filters like depth, size, and binary detection within max_walker_depth (defaults to 5) for efficient code context.

- Tags: internals
- Published: 2026-04-08

### [Differences Between Forge, Sage, and Muse Agents in Forgecode](/antinomyhq/forgecode/forge-sage-muse-agents-differences-use-cases)

Discover how Forge, Sage, and Muse agents in Forgecode differ. Learn their use cases: Forge for code execution, Sage for research, and Muse for strategic planning to optimize your development workflow.

- Tags: comparison
- Published: 2026-04-08

### [How Forge Handles API Request Retries: Configuration and Environment Variables](/antinomyhq/forgecode/forge-api-request-retry-logic-environment-variables)

Learn how Forge handles API request retries with a two-layer system and exponential backoff. Discover how to configure retry attempts and backoff duration using environment variables like FORGE_RETRY_MAX_ATTEMPTS for robust int...

- Tags: how-to-guide
- Published: 2026-04-08

### [How Conversation Cloning Works in Forge: Immutable Branching and Data Flow](/antinomyhq/forgecode/forge-conversation-cloning-branching-data-flow)

Discover how Forge's conversation cloning creates new UUIDs and shallow copies immutable structs. Learn about branching conversations and their on-demand resolution.

- Tags: internals
- Published: 2026-04-08

### [Forge Policy Engine Architecture: How File System Operations Are Restricted](/antinomyhq/forgecode/forge-policy-engine-architecture-filesystem-restrictions)

Explore Forge's policy engine architecture. Learn how its three-layer defense system converts file system operations into PermissionOperations and evaluates them against Policy rules for secure I/O control.

- Tags: architecture
- Published: 2026-04-08

### [How to Create Custom Agents with Specific Tools and System Prompts in Forge](/antinomyhq/forgecode/forge-create-custom-agents-tools-prompts)

Learn to create custom agents in Forge by defining tools and system prompts in YAML files. Forge loads and renders your agents effectively for enhanced automation.

- Tags: how-to-guide
- Published: 2026-04-08

### [How Semantic Search Indexing Works in Forge: A Technical Deep Dive](/antinomyhq/forgecode/forge-semantic-search-indexing-workspace-server-data)

Discover how Forge's semantic search indexing efficiently transmits code changes and performs vector similarity queries on your codebase.

- Tags: deep-dive
- Published: 2026-04-08

### [How the Forge Sandbox Feature Creates Isolated Git Worktrees for Safe Experimentation](/antinomyhq/forgecode/forge-sandbox-git-worktree-isolation-experimentation)

Forge's sandbox feature isolates Git worktrees for safe experimentation. Effortlessly test code changes outside your main repository without risk. Discover risk-free development.

- Tags: internals
- Published: 2026-04-08

### [Session-Only vs Persistent Configuration in the Forge ZSH Plugin: A Complete Guide](/antinomyhq/forgecode/forge-zsh-plugin-session-vs-persistent-configuration)

Understand the difference between session-only and persistent configuration in the Forge ZSH plugin. Learn how Forge stores temporary and permanent settings to optimize your shell environment. Read our complete guide.

- Tags: how-to-guide
- Published: 2026-04-08

### [How antinomyhq/forgecode Implements the Model Context Protocol (MCP): Architecture and Limitations](/antinomyhq/forgecode/forgecode-model-context-protocol-implementation-limitations)

Discover how antinomyhq/forgecode implements the Model Context Protocol (MCP) as a dynamic tool provider. Explore its architecture and understand its limitations regarding timeouts and streaming.

- Tags: architecture
- Published: 2026-04-08

### [How the Forge Zsh Plugin Intercepts and Routes ':' Prefix Commands to the CLI](/antinomyhq/forgecode/forge-zsh-plugin-command-interception-routing)

Discover how the Forge Zsh plugin intercepts and routes ':' prefix commands to the Forge CLI. Learn about its custom ZLE widget and regex parsing for seamless command execution.

- Tags: internals
- Published: 2026-04-08

### [Forge Tool Execution Architecture: Domain Layer and Service Interaction](/antinomyhq/forgecode/forge-tool-execution-architecture-service-domain-interaction)

Explore Forge's tool execution architecture. Understand how the domain layer defines contracts and service traits interact with the executor for efficient orchestration.

- Tags: architecture
- Published: 2026-04-08

### [How the antinomyhq/forgecode Context Compaction Algorithm Works: A Complete Guide](/antinomyhq/forgecode/forgecode-context-compaction-algorithm-tuning)

Explore the antinomyhq/forgecode context compaction algorithm. Learn how its three-layer pipeline optimizes token usage without losing vital information. Discover tuning strategies.

- Tags: deep-dive
- Published: 2026-04-08