Repolode
Submit
tailcallhq

tailcallhq/forgecode

A terminal-based AI coding agent in Rust that works with many LLM providers, offering a TUI, one-shot CLI, and ZSH plugin modes.

Open-source alternative to:Claude Code

View on GitHubWebsite
Stars
7,637
Forks
1,460
Open issues
33
Last commit
6 hours ago

What is it?

Forge is an AI coding agent that runs in your terminal. It can read and edit files in a project, run shell commands, and keep multi-step conversations going across a session. You can use it as an interactive TUI, as a one-shot command for scripts, or through a ZSH plugin that lets you send prompts with a `:` prefix from your shell prompt.

Forge supports a wide range of model providers, including Claude, GPT, Grok, Gemini, DeepSeek and OpenRouter, and provider credentials are managed with `forge provider login`. It ships with three built-in agents: `forge` for implementation, `sage` for read-only research, and `muse` for writing plans. Custom agents, skills, commands and `AGENTS.md` instructions can be added per project or globally.

The project also includes commit message generation, natural-language-to-shell-command suggestions, conversation management with export to JSON or HTML, MCP server integration, and optional semantic search over a codebase through an indexing server.

Key features

  • 01Interactive TUI, one-shot CLI, and ZSH plugin usage modes
  • 02Supports many LLM providers including Claude, GPT, Gemini and OpenRouter
  • 03Built-in agents for implementation, read-only research and planning
  • 04AI-generated git commit messages and natural-language shell command suggestions
  • 05Saved conversations that can be resumed, cloned, and exported
  • 06MCP server integration and custom skills, agents and commands

Use cases

  • Making multi-file changes to a codebase from the terminal
  • Asking questions about unfamiliar code or tracing how a feature works
  • Generating commit messages and PR descriptions from a diff
  • Running AI-assisted tasks inside scripts or CI-style pipelines

Quick start

  1. 1

    Install Forge with the install script from the README

  2. 2

    Log in to your AI provider

    forge provider login
  3. 3

    Start Forge

    forge

Things to know

  • Requires credentials or an API key from an AI provider to be useful.
  • Installation relies on a curl-to-shell install script.

Topics

#ai-coding#cli#terminal#llm#zsh#rust#coding-agent#mcp#ai-pair-programming#ai-workflows

FAQ

What is forgecode?
A terminal-based AI coding agent in Rust that works with many LLM providers, offering a TUI, one-shot CLI, and ZSH plugin modes. Forge is an AI coding agent that runs in your terminal. It can read and edit files in a project, run shell commands, and keep multi-step conversations going across a session. You can use it as an interactive TUI, as a one-shot command for scripts, or through a ZSH plugin that lets you send prompts with a `:` prefix from your shell prompt.
Is forgecode free to use? What license does it have?
forgecode is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is forgecode still maintained?
Actively maintained. The last commit to forgecode was on Oct 21, 2026.
What can I use forgecode for?
Making multi-file changes to a codebase from the terminal Asking questions about unfamiliar code or tracing how a feature works Generating commit messages and PR descriptions from a diff Running AI-assisted tasks inside scripts or CI-style pipelines
How do I install forgecode?
Install Forge with the install script from the README Log in to your AI provider: forge provider login Start Forge: forge
Where can I get forgecode?
The source code and installation instructions are on GitHub: https://github.com/tailcallhq/forgecode

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects