Skip to content
/

InsForge

insforge · InsForge/InsForge · ★ 11k · last commit 2026-05-26

Primitive shape 3 total
Skills 2 MCP tools 1
00

Summary

InsForge — Summary

InsForge is an open-source backend-as-a-service platform purpose-built for AI coding agents, giving agents direct access to database, auth, storage, edge functions, model gateway, compute, and site deployment through either an MCP server or a CLI+Skills interface. Rather than providing workflow methodology or prompt engineering patterns, InsForge solves the "last mile" problem: an agent can design and implement a backend feature, but cannot deploy it, run migrations, or verify it works at runtime without external infrastructure access. InsForge bridges that gap by exposing infrastructure operations as MCP tools any MCP-compatible agent can call. The platform ships as a Docker Compose stack for self-hosting and as a managed cloud service at insforge.dev. It integrates with Claude Code via a dedicated plugin (2 skills: insforge-dev for monorepo contributors, doc-author vendored from Mintlify) and with Codex via a separate plugin manifest.

Among the 11 seeds, InsForge most closely resembles ccmemory in that both are MCP-anchored toolservers, but InsForge's scope is infrastructure operations rather than memory management: where ccmemory gives agents a Neo4j graph of codebase knowledge, InsForge gives agents a Postgres database, S3 storage, auth system, and serverless compute — making it a complete backend runtime for full-stack agent-built applications rather than a coding harness enhancement.

01

Overview

InsForge — Overview

Origin

InsForge was launched in 2025-2026 by the InsForge organization. It is a TypeScript monorepo using Turborepo, with a React/Vite frontend shell and a shared dashboard package. The project reached 10,636 stars as of 2026-05-26 and is actively maintained (last push same day). It received inclusion in Vercel's OSS Program and Trendshift tracking.

Philosophy

The README states: "The all-in-one, open-source backend platform for agentic coding. InsForge gives your coding agent database, auth, storage, compute, hosting, and AI gateway to ship full-stack apps end-to-end."

The core philosophy is that coding agents need infrastructure access, not just code generation assistance. An agent that can write a PostgreSQL migration but cannot run it is incomplete. InsForge closes this loop by making backend operations agent-callable.

How Agents Interact

Two interfaces:

  1. MCP Server (self-hosted and cloud): Any MCP-compatible agent calls InsForge operations as tools
  2. CLI + Skills (cloud only): A command-line interface paired with skills agents invoke from the terminal

Both interfaces enable agents to:

  • Pull documentation, schemas, metadata, and runtime logs (read context)
  • Deploy edge functions, run migrations, create storage buckets, configure auth providers (write operations)

Architecture Principle

Agents need to be able to act as "backend engineers," not just code writers. InsForge materializes this by making every infrastructure primitive available as an MCP tool call or CLI command.

Explicit Focus

InsForge is not a coding methodology framework. It does not ship workflow phases, spec formats, or agent behavioral guidelines. It ships infrastructure. The insforge-dev skill is for InsForge's own contributors, not for end users.

02

Architecture

InsForge — Architecture

Distribution

  • Docker Compose (self-hosted)
  • Cloud service at insforge.dev
  • Claude Code plugin: claude plugin install insforge
  • Codex plugin via .codex-plugin/plugin.json
  • npm SDK: @insforge/sdk

Install Methods

# Self-hosted
docker compose up

# Claude Code plugin
/plugin marketplace add InsForge/InsForge
/plugin install insforge

# Quick deploy (Railway/Zeabur/Sealos)
# One-click buttons in README

Required Runtime

  • Docker + Docker Compose (self-hosted)
  • Node.js (for SDK)

Repository Structure (Turborepo monorepo)

InsForge/
├── .claude/skills/           # Claude Code skills (2)
│   ├── insforge-dev/         # Monorepo contributor skill
│   └── doc-author/           # Mintlify vendored skill
├── .claude-plugin/           # Claude Code plugin manifest
├── .agents/skills/           # Cross-agent skills directory
├── .codex/skills/            # Codex-specific skills
├── .gstack/qa-reports/       # QA automation reports
├── backend/                  # API, auth, database, providers, realtime
├── frontend/                 # React + Vite self-hosting shell
├── packages/
│   ├── dashboard/            # Publishable dashboard package
│   ├── shared-schemas/       # Cross-package contracts
│   └── ui/                   # Design system primitives
├── openapi/                  # OpenAPI specs per service
│   ├── ai.yaml               # AI/model gateway
│   ├── auth.yaml             # Authentication
│   ├── tables.yaml           # Database tables
│   ├── storage.yaml          # File storage
│   ├── functions.yaml        # Edge functions
│   └── ... (14 total)
├── CLAUDE_PLUGIN.md          # Plugin documentation
├── AGENTS.md                 # Agent usage guide
└── docker-compose.yml        # Self-hosted deployment

Target AI Tools

  • Claude Code (primary: MCP server + plugin)
  • Codex (plugin manifest at .codex-plugin/plugin.json)
  • Any MCP-compatible agent (Cursor, Windsurf, JetBrains, etc.)

MCP Server Exposure

The MCP server connects at http://localhost:7130 when self-hosted. It exposes operations across all InsForge services as MCP tools. Documented tool count: at minimum fetch-docs (docs fetching) plus operations per OpenAPI spec (14 spec files × ~5-10 operations = ~70-140 estimated tools; exact count not in public documentation).

03

Components

InsForge — Components

Claude Code Skills (2)

Name Purpose
insforge-dev Guides contributors working inside the InsForge monorepo; routes tasks to the correct package layer (backend, dashboard, ui, shared-schemas, docs)
doc-author Vendored from Mintlify; handles documentation writing, collaborative drafting, and PR creation for docs

MCP Server (1 server, estimated 70-140+ tools)

The MCP server exposes InsForge operations as tools. Each service domain has its own OpenAPI spec:

Domain OpenAPI Spec Representative Operations
Authentication auth.yaml User management, sessions, auth providers
Database tables.yaml Migrations, queries, schema management
Storage storage.yaml Bucket creation, file operations
AI Gateway ai.yaml Multi-provider LLM routing
Edge Functions functions.yaml Deploy, invoke, logs
Realtime realtime.yaml WebSocket channels, pub/sub
Payments payments.yaml Payment provider configuration
Secrets secrets.yaml Secret management
Deployments deployments.yaml Site deployment
Logs logs.yaml Runtime log retrieval
Metadata metadata.yaml Project metadata, schemas
Health health.yaml Service health checks
Email email.yaml Email provider configuration
Records records.yaml Database record operations

Explicit tool: fetch-docs — fetches InsForge documentation and agent instructions.

Infrastructure Services (Core Products)

Service Description
Authentication User management, authentication, sessions
Database Postgres relational database
Storage S3-compatible file storage
Model Gateway OpenAI-compatible API across multiple LLM providers
Edge Functions Serverless code running at the edge
Compute Long-running container services (private preview)
Site Deployment Site build and deployment

Scripts

Located in scripts/ (monorepo tooling). Includes update-mintlify-skill.sh for syncing the doc-author skill from upstream Mintlify.

QA Reports

.gstack/qa-reports/ — automated QA output stored in the repository.

05

Prompts

InsForge — Prompts

Excerpt 1 — insforge-dev Skill (SKILL.md)

---
name: insforge-dev
description: Use this skill set when contributing to the InsForge monorepo itself. This is for InsForge maintainers and contributors editing the platform, the shared dashboard package, the self-hosting shell, the UI library, shared schemas, tests, or docs.
---

# InsForge Dev

Use this skill set for work inside the InsForge repository.

Then use the narrowest package skill that matches the task:
- `backend`
- `dashboard`
- `ui`
- `shared-schemas`
- `docs`

## Core Rules

1. Identify the package boundary before editing.
   - `backend/`: API, auth, database, providers, realtime, schedules
   - `packages/dashboard/`: publishable dashboard package that supports `self-hosting` and `cloud-hosting` modes
   - `frontend/`: local React + Vite shell that mounts `packages/dashboard/` in `self-hosting` mode
   - `packages/shared-schemas/`: cross-package contracts
   - `packages/ui/`: reusable design-system primitives
   - `docs/`: product and agent-facing documentation

2. Put code in the narrowest correct layer.
   - Contract change: `packages/shared-schemas/` first, then consumers.
   - Backend behavior: route -> service -> provider/infra.
   ...

Prompting technique: Package-boundary routing. The skill functions as a decision tree that routes the agent to the correct sub-skill based on what it is editing, enforcing monorepo architecture discipline. This is a "narrowest-layer-first" instruction pattern.

Excerpt 2 — doc-author Skill (SKILL.md, vendored from Mintlify)

---
name: doc-author
description: Write, edit, and maintain documentation. Use for collaborative drafting, autonomous writing, or improving existing docs. Defaults to collaborative mode where the human makes final decisions. Built by Mintlify.
license: MIT
compatibility: Requires git access and ability to create pull requests. Works with any markdown or MDX documentation. Optimized for Mintlify-powered documentation sites.
metadata:
  author: Mintlify
  url: https://mintlify.com
  version: "0.2"
---

<!--
  Vendored from https://github.com/mintlify/docs (commit 877f90193ea1)
  Upstream path: .claude/skills/doc-author/SKILL.md
  Upstream license: MIT
  Vendored: 2026-04-18 by scripts/update-mintlify-skill.sh
...

Prompting technique: Vendored upstream skill with explicit provenance tracking. The INSFORGE.md companion file and the vendor script (update-mintlify-skill.sh) ensure the skill stays in sync with Mintlify's upstream. This is a "skill-as-dependency" pattern — InsForge treats third-party skills as versioned library dependencies.

Excerpt 3 — Agent Onboarding Prompt (AGENTS.md / README)

I'm using InsForge as my backend platform, call InsForge MCP's fetch-docs tool 
to learn about InsForge instructions.

Prompting technique: Self-bootstrapping prompt. The agent is instructed to call fetch-docs first, which pulls the InsForge operation manual. This defers the full system prompt to a runtime tool call, keeping the initial user prompt minimal while ensuring the agent has current documentation.

09

Uniqueness

InsForge — Uniqueness

Differs from Seeds

InsForge occupies a category unique among the corpus: it is a backend infrastructure platform for agents, not a coding harness or workflow methodology. The closest seed is ccmemory, which also uses an MCP server as its primary interface, but ccmemory provides graph-based code knowledge, while InsForge provides deployable Postgres, auth, S3 storage, edge functions, and a model gateway — the actual backend infrastructure an agent-built application needs to run. No seed framework addresses the problem of "agent can write code but cannot deploy it." Taskmaster-AI manages task decomposition; InsForge manages infrastructure state. Claude-flow provides multi-agent orchestration; InsForge provides the services those agents would build against. The fetch-docs self-bootstrapping pattern (agent calls fetch-docs on first use to get current API docs) is a runtime documentation injection technique not present in any seed.

Positioning

InsForge is a "backend for AI coding" — it makes the infrastructure layer agent-callable. The positioning is: agents are good at writing code but bad at managing infrastructure because they cannot actually run migrations or deploy functions. InsForge resolves this by making every infrastructure operation an MCP tool call. This makes InsForge complementary to, rather than competitive with, workflow frameworks like openspec or taskmaster-ai.

Observable Failure Modes

  1. Vendor lock-in: Applications built with InsForge are coupled to InsForge's API surface. Migrating off requires significant refactoring of agent-generated code.
  2. Cloud-only CLI: The CLI + Skills interface is cloud-only, creating a feature gap for self-hosted users.
  3. Undocumented tool count: The exact number of MCP tools is not enumerated in the public README, making it difficult for agents to discover capabilities without calling fetch-docs.
  4. No conflict handling: Multiple agents operating on the same InsForge project can run conflicting migrations or deploy conflicting function versions — InsForge provides no coordination layer for this.
04

Workflow

InsForge — Workflow

InsForge is infrastructure, not a workflow methodology framework. The agent workflow enabled by InsForge is:

Agent Development Workflow (using InsForge)

Phase Agent Action InsForge Tool Called
1. Understand Read backend context fetch-docs, metadata tools
2. Design Inspect schemas and existing config tables, auth, functions metadata tools
3. Implement Write code that uses InsForge services (code generation — no InsForge tool needed)
4. Deploy Run migrations, deploy functions migration tools, functions deploy tools
5. Verify Pull runtime logs, check health logs tools, health tools
6. Debug Investigate failures logs, metadata, realtime tools

Approval Gates

None defined at the InsForge level. Infrastructure operations are invoked directly by the agent without confirmation gates in the framework.

Artifacts Produced

Artifact Producer
Database migrations Agent (via database tools)
Deployed edge functions Agent (via functions tools)
Auth configuration Agent (via auth tools)
Storage buckets Agent (via storage tools)
Runtime logs InsForge platform (readable via logs tools)

Self-Hosting vs Cloud Workflow

Self-hosted: Docker Compose on local machine or server. MCP connects at http://localhost:7130. Full control, no external dependencies.

Cloud: insforge.dev — managed infrastructure. Agent connects to cloud MCP server. CLI+Skills interface also available (cloud-only feature).

06

Memory Context

InsForge — Memory & Context

State Storage

InsForge's state is primarily infrastructure state — it is the backend itself:

State Type Storage Persistence
Database schemas + data Postgres (InsForge-managed) Global / project
Deployed functions Edge function runtime Global / project
Auth configuration InsForge auth service Global / project
Storage buckets + files S3-compatible store Global / project
Runtime logs InsForge log service Temporal
QA reports .gstack/qa-reports/ in repo Project

Agent Context via MCP

The fetch-docs tool gives agents access to the current InsForge documentation and operation manual at runtime, rather than embedding it in a static CLAUDE.md. This is a dynamic context injection pattern: the agent pulls current docs on demand.

The metadata tools let agents query live schema state — which tables exist, which columns have which types, which auth providers are configured — rather than relying on stale documentation.

Cross-Session Handoff

Yes — infrastructure state persists between agent sessions. An agent that deploys a function in one session, and a different agent session that inspects logs for that function, share the same infrastructure state via InsForge.

Memory Type

The InsForge platform itself acts as a persistent backend for agent-built applications. For agent coordination purposes, it provides no explicit memory/vector storage mechanism — that's out of scope. The metadata tools provide a form of structural memory (schema introspection).

Context Compaction

Not applicable — InsForge is not a conversational framework. The agent's context is refreshed via fetch-docs and metadata tool calls at the start of each session.

07

Orchestration

InsForge — Orchestration

Multi-Agent

No agent orchestration is built into InsForge itself. Multiple agents can independently call the InsForge MCP server (it is a stateless API), but InsForge does not coordinate their work — that's the responsibility of the agent harness using InsForge.

Orchestration Pattern

none — InsForge is an infrastructure platform, not an orchestrator. It responds to MCP tool calls; it does not direct agent behavior.

Isolation Mechanism

At the infrastructure level, InsForge supports multi-project isolation: each project has its own database, storage buckets, functions, and auth configuration. Multiple agents can work on different InsForge projects independently. Within a single project, no file-lease or worktree isolation is provided.

Execution Mode

event-driven — InsForge responds to MCP tool calls on demand. It does not run on a schedule or poll for work.

Multi-Model

No — InsForge itself does not route different LLM models. The Model Gateway service routes LLM calls within applications built on InsForge, but InsForge as a platform does not assign models to roles.

Consensus Mechanism

None.

Cross-Tool Portability

High — any MCP-compatible agent can call InsForge tools (Claude Code, Cursor, Windsurf, JetBrains, Zed, Codex, etc.). The MCP protocol is the only interface requirement.

08

Ui Cli Surface

InsForge — UI & CLI Surface

Dedicated CLI Binary

No CLI binary as a user-facing tool. The platform exposes MCP tools, not a CLI for direct use.

Local Web Dashboard

Yes — the InsForge platform includes a web dashboard accessible at http://localhost:7130 (self-hosted). The dashboard covers:

  • Service status and health checks
  • MCP connection setup walkthrough
  • Database schema viewer
  • Edge function management
  • Storage browser
  • Auth configuration
  • Realtime channel monitoring
  • Log viewer

Tech stack: SvelteKit (embedded in the Go/Docker stack via the packages/dashboard publishable package). The frontend shell uses React + Vite, but the dashboard package itself uses SvelteKit.

Agent Interface

MCP Server — at http://localhost:7130 (self-hosted). All infrastructure operations are exposed as MCP tools. This is the primary interface for coding agents.

CLI + Skills (cloud only) — a command-line interface paired with skills for the cloud-hosted version.

Plugin Integration

  • Claude Code plugin: insforge — installs insforge-dev and doc-author skills
  • Codex plugin: .codex-plugin/plugin.json manifest

Observability

  • .gstack/qa-reports/ — automated QA reports committed to the repository
  • Runtime logs accessible via logs MCP tools
  • Health status via health MCP tools

Self-Hosting vs Cloud UI

Feature Self-hosted Cloud
Web dashboard Yes (localhost:7130) Yes (insforge.dev)
MCP server Yes Yes
CLI + Skills No Yes
Analytics Limited Full

Related frameworks

same archetype · same primary tool · same memory type

MemPalace ★ 53k

Verbatim local-first AI memory with 96.6% R@5 retrieval on LongMemEval using zero API calls — structured into a palace hierarchy…

Beads (Yegge) ★ 24k

Dolt-powered distributed graph issue tracker where AI agents track tasks with hierarchical IDs and dependency edges, claim work…

deepagents (LangChain) ★ 23k

Opinionated Python agent harness on top of LangGraph with sub-agents, filesystem, memory, and context compaction bundled in

agentmemory ★ 18k

Persistent, searchable memory for AI coding agents that captures every tool interaction, compresses it via LLM, and injects…

Open Multi-Agent ★ 6.3k

Give a natural-language goal to a coordinator agent and get a dynamically decomposed, parallelized task DAG executed by…

Basic Memory ★ 3.1k

Gives AI agents a persistent, human-readable knowledge graph of project decisions, observations, and relations stored as plain…