insforge-cli skill (InsForge): manage your InsForge backend from the CLI

InsForge's own skill that has a coding agent run the InsForge CLI to manage projects, SQL, functions, secrets, deployments and billing.

Installs: 62.4K; on skills.sh
Stars: 47; on GitHub
Files: 29; besides SKILL.md
Updated: Oct 2026; last repo commit

insforge-cli makes your coding agent run the InsForge command line tool to set up and manage a backend: log in, create or link a project, run SQL and migrations, deploy edge functions and frontends, and handle secrets, storage, backups and branches.

It covers a lot of destructive and billing commands. SKILL.md tells the agent to confirm project, organization and backup actions with you first, but it also documents a --yes flag that skips confirmations. Read what the agent proposes before you approve it.

Good for

Developers building an app on InsForge's Postgres-based backend
Developers who need a database, storage and edge functions set up for an app
Teams running InsForge commands in CI with environment variables

Install insforge-cli

Claude Code

Copy this prompt.

Install the insforge-cli skill in Claude Code. Run this command:

/plugin marketplace add InsForge/insforge-skills
/plugin install insforge@insforge

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Pick one route, not both. The skills CLI asks which skills to take: pick insforge-cli. SKILL.md does not need the other three to run. The plugin route installs all 4. The skills run the InsForge CLI with npx, which needs Node.js 18 or newer, and you need an InsForge account and project. The README lists /install-skills under Claude Code. It is not a documented Claude Code built-in and we have not confirmed it works, so prefer the plugin or the skills CLI.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

Use this skill whenever someone needs a backend, or a task touches InsForge backend or cloud infrastructure through the InsForge CLI: projects, SQL, migrations, RLS policies, functions, storage, backups, deployments, compute, secrets, config, schedules, logs, diagnostics, advisor scans and suppressions, import/export, AI/OpenRouter setup and usage overview, Stripe/Razorpay payments, Apify web scraping / data sources, PostHog product analytics, backend branches, organization membership (invite, leave, delete), agent memory (remember/recall project facts and decisions), reporting InsForge-side bugs or doc discrepancies (feedback), or CLI docs. For app code with InsForge or @insforge/sdk, use the insforge app-integration skill instead.

Sections in SKILL.md

Core Rules
Global Options
Exit Codes
Environment Variables
Connection Setup
Command Routing
Database Workflow
Project and Configuration
Organizations and Members
Billing and Usage
Backups
Storage
Realtime
Edge Functions
AI Gateway
Memory

Key facts

Author: InsForge (vendor's own repo, README and plugin manifests)
License: Apache 2.0 (LICENSE file, README, SKILL.md and both plugin manifests agree)
Installs on skills.sh: 62,445 as of 2026-11-02
GitHub stars: 47 for the whole insforge-skills repo, 2026-11-02
What is inside: 30 files including SKILL.md: 28 reference guides (database, branch, payments, deployments and more) plus agents/openai.yaml. It bundles no scripts.
Last change to this skill: 2026-10-24
Part of: The insforge plugin (4 skills) in the insforge marketplace
Needs: Node.js 18 or newer for @insforge/cli, run through npx, and an InsForge project

What it includes

Log in, then create or link a project before building
Runs whoami, login (browser, device login or a user API key), then create or link. SKILL.md says to do this before writing app code and never to scaffold with placeholder credentials.
Runs code · Connection setup
SQL, migrations, RLS, import and export
Prefers db migrations new and db migrations up --all for schema changes, and db query for inspection. It keeps changes inside the public schema unless a feature guide allows more.
Delete · Database
Status, rename, restore, update, resize, delete, transfer, members
Includes projects delete, projects upgrade-instance (which changes the bill), orgs members invite and orgs delete, which deletes every project in the org.
Delete · Projects and organizations
Plan, credits, usage, history, upgrade
billing upgrade starts a Stripe checkout, and SKILL.md says no charge happens until you complete it.
Runs code · Billing and usage
List, create, rename, delete, restore
On a cloud project, restore overwrites the current database and storage, so data written after the backup is lost.
Delete · Backups
Buckets, objects and S3-compatible keys
Includes delete-bucket, which removes all objects, and s3-keys create, whose secret is shown once.
Delete · Storage
Deploy, invoke and delete functions; run containers
functions deploy, invoke, delete and code, plus compute deploy for a directory with a Dockerfile or a prebuilt image.
Delete · Edge functions and compute
Secrets, key rotation, and insforge.toml config
secrets get prints a value, secrets rotate prints a new key once, and config export, plan and apply manage supported settings.
Delete · Secrets and config
Deploy a frontend and attach custom domains
deployments deploy takes a source directory. domains covers custom domains, Cloudflare Registrar, DNS sync and SSL verification.
Runs code · Deployments and domains
Create, switch, merge, reset and delete backend branches
branch merge --dry-run shows the SQL before it is applied to the parent.
Delete · Branches
OpenRouter key setup, Stripe and Razorpay setup, cron jobs
ai setup writes OPENROUTER_API_KEY to a local env file. payments sets provider keys and syncs the catalog; SKILL.md says to prefer test mode and use live mode only after your approval.
Runs code · AI, payments, schedules
Logs, health checks, advisor scans, project memory
Includes diagnose --ai, advisor suppress with a recorded reason, and memory remember, recall and list for facts that persist across sessions.
Runs code · Diagnostics, advisor and memory
Analytics setup and a web-scraper connection
posthog setup prints a wizard command and the project's public key. webscraper apify login runs apify login --token and installs Apify's official agent skills.
Runs code · PostHog and Apify

From the official docs

Permissions

High risk

This skill runs commands that can delete projects and organizations, overwrite data from a backup, run SQL, rotate keys and change your bill. Approve each destructive command yourself, and use a branch or a test project first.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can delete projects and whole organizations
projects delete is irreversible, and orgs delete removes every project in the organization and cancels the subscription. SKILL.md says to confirm the exact id with you; do not approve either unless you asked for it. github.com
A backup restore overwrites live data
On a cloud project, backups restore replaces the current database and storage, and data written since the backup is lost. Create a fresh backup first. github.com
--yes skips the confirmation prompts
SKILL.md documents -y/--yes to auto-accept delete and overwrite prompts once you have approved the action. A broad approval can cover more than you meant, so approve one command at a time. github.com
Some commands change your bill
projects upgrade-instance changes the bill and restarts the project, and billing upgrade starts a Stripe checkout. Check the plan and instance size before you confirm. github.com
The project API key is a full-access admin key
Keep it server-only and out of public env vars. Rotated keys are printed once, so store them safely. github.com
Bug reports go to InsForge
The feedback command sends a report to the InsForge team with pattern-based local redaction. Keep user data out of the text. github.com
The InsForge CLI sends usage events to PostHog
The CLI source says each command emits one PostHog event with non-sensitive properties, and uses an anonymous ID when no project is linked. The skill runs the CLI through npx, so those events come with it. github.com
The plugin route installs all 4 skills
The Claude and Codex plugin manifests cover the whole skills folder, which holds 4 skills, and the git tree has no hooks or MCP config. The Codex marketplace file sets authentication to ON_INSTALL. github.com
agents/openai.yaml holds interface settings
Each skill folder includes an agents/openai.yaml with a display name, short description, brand color and a default prompt. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Talks to	api.insforge.dev and your InsForge project URL. npm registry (the CLI runs through npx). Stripe checkout and billing portal links. PostHog and Apify, when those setup commands run
Sign-in and keys	SKILL.md lists INSFORGE_ACCESS_TOKEN, INSFORGE_EMAIL and INSFORGE_PASSWORD, and a user API key created in the dashboard. After create or link, .insforge/project.json holds the project ID, app key, region, API key and backend URL; SKILL.md says never to commit it.
Data retention	Not stated in SKILL.md. The memory commands store facts, decisions and preferences in the InsForge project.
Scopes	Runs npx -y @insforge/cli with your logged-in account or INSFORGE_ACCESS_TOKEN Can run raw SQL and apply migrations on the linked project Can delete projects, organizations, buckets, functions, secrets and backups Can restore a backup, which overwrites the cloud project's database and storage Writes .insforge/project.json and local env files apify login installs Apify's official agent skills

Questions

What does the insforge-cli skill do?

It has your coding agent run @insforge/cli to manage an InsForge backend: projects, SQL and migrations, edge functions, storage, secrets, deployments, backups, branches, billing and diagnostics.

How do I install insforge-cli?

Use the install box at the top of this page. insforge-cli does not need the other InsForge skills to run, so with the skills CLI you can pick just it; the plugin route installs all 4. You also need Node.js 18 or newer and an InsForge account.

Does it need an account or API key?

Yes. It logs in through your browser, with email and password variables, or with a user API key from the dashboard under Profile and API Keys. It can also link a self-hosted backend by URL and admin API key.

Can insforge-cli delete my data?

Yes. It can delete projects, organizations, buckets, functions, secrets and backups, and a backup restore overwrites the cloud database and storage. SKILL.md says to confirm the exact target with you first. Our advice: approve each of those commands one at a time.

Is insforge-cli safe?

It acts on a real backend with your account, so safety depends on what you approve. Use a test project or a branch for experiments, and do not give blanket approval for --yes runs.

Does it cost money to use?

The skill is free. InsForge plans, instance sizes and credits are billed by InsForge, and SKILL.md says an instance upgrade changes the bill. No charge happens from billing upgrade until you finish the Stripe checkout.

insforge-cli or insforge?

insforge-cli manages the backend with the CLI. The insforge skill writes app code with @insforge/sdk. SKILL.md in each points to the other.

Is this the official InsForge skill?

Yes. It is in InsForge's own insforge-skills repo, and the plugin manifests name InsForge as author.

Information

updated Nov 2, 2026

Repository: insforge/insforge-skills
Folder: skills/insforge-cli

insforge/insforge-skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

marketplace.json · github.com
README.md · github.com
README.md · github.com
plugin.json · github.com
SKILL.md · github.com
command-telemetry.ts · github.com