🔨
Npxstack Forgev0.2.2
Autonomous Execution • Self-Healing Test Loops • SQLite Audit Ledger • Zero-Leak Privacy

The Autonomous AI Software Engineering Platform for Terminal, Scripts & CI/CD

Beyond a simple terminal chat loop. Npxstack Forge orchestrates the entire engineering lifecycle: headless task runs (forge run), repository preflight inspection, automated test & self-healing regression repair, persistent SQLite ledgers, financial budget controls, and hybrid offline Ollama + Cloudflare Edge models.

⚡ Headless CI/CD Automation🔄 Self-Healing Test Repair🔍 Stack Preflight Inspector🗄️ Local SQLite Audit Ledger💰 Hard Budget Cost Caps🦙 100% Offline Ollama
One-Line Automated Installer
irm https://cli.npxstack.dev/forge/install.ps1 | iex
After install, type forge in any repository root.npm: @npxstack/forge@0.2.2
⚡
<500ms TTFT
Cloudflare 300+ Edge Cities
🛡️
PathGuard Guardrail
Zero Path Traversal Risk
🦙
100% Offline Ollama
Zero Cloud Egress for Private IP
📜
Apache 2.0 Open Source
Audit CLI on GitHub
Terminal & Automation Simulation

Comprehensive Platform in Action

Switch scenarios to see autonomous batch runs, test self-healing, stack inspection, and interactive pair-programming.

npxforge-runner — zsh — 80x24
$ forge run "Resolve token expiration regression in auth.service" --yes-safe --max-cost 0.50
🔨 Npxstack Forge v0.2.2 [Headless Autonomous Runner]
Run ID: run_8f41e0a2 • Budget Cap: $0.50 USD • Mode: cloud-ok
➜ Phase 1: Preflight & Workspace Architecture Analysis
[Inspector] Project type: TypeScript Node.js, Test runner: Vitest (pnpm test)
[Inspector] PathGuard active: workspace root locked at /home/dev/npxstack/platform
➜ Phase 2: Autonomous Patch Formulation & Implementation
[Patch] src/auth/token.service.ts — Added clockSkewTolerance and refresh window buffer
➜ Phase 3: Automated Test Execution (pnpm test auth)
✗ test/auth.test.ts: token expiry edge case failed (expected 200, got 401)
➜ Phase 4: Self-Healing Repair Cycle [1/3]
[Analyzer] Detected millisecond vs second unix timestamp discrepancy
[Repair Patch] Normalized exp epoch calculation with Math.floor(Date.now() / 1000)
➜ Phase 5: Re-running Verification Tests
✓ test/auth.test.ts (14 tests passed, 38ms)
✓ Task completed headlessly. Ledger updated: 0.008 USD consumed (0.016% of budget).
Holistic Engineering Capabilities

The Complete Software Engineering Agent Suite

Forge is not just an interactive terminal chat. It is an end-to-end autonomous engineering platform covering headless tasks, stack inspection, test-driven repair, and financial cost governance.

🤖
forge run <goal> --yes-safe

Autonomous Task Runner & Headless CI/CD

Execute end-to-end coding tasks headlessly in scripts or CI/CD pipelines without manual prompts. Forge autonomously investigates the repository, designs a structured plan, edits files, and delivers verified results.

  • ✓Unattended scriptable execution for automated bug fixes
  • ✓Auto-approve safe operations with --yes-safe flag
  • ✓Decision cycle bounds (--max-cycles) prevent infinite loops
🔄
Autonomous Test & Patch Loop

Test-Driven Verification & Self-Healing Repair

Never commit broken code. Forge automatically discovers your test runner (Vitest, Jest, PyTest, Go test), executes the test suite, parses failure stack traces, and initiates iterative repair cycles until all tests pass.

  • ✓Iterative self-repair loop bounded by safety limits
  • ✓Captures stdout/stderr within bounded buffers
  • ✓Zero-regression guarantee before finalizing git diffs
🔍
forge inspect & forge doctor

Repository Architecture & Stack Preflight

Deep automated preflight of your codebase. Automatically detects frameworks (Next.js, Node, Python, Go, Rust), package managers, scripts, and protected assets, while diagnosing system readiness.

  • ✓Automatic stack, package manager, and test runner detection
  • ✓Full environment health checks with forge doctor
  • ✓System probes for Ollama daemon, Git tree, and edge gateway
💬
forge (Interactive REPL)

Interactive Terminal Pair-Programming

For engineers who love the shell. An interactive terminal session with multi-turn context memory, in-terminal syntax-highlighted git diffs, and instant slash commands to control every aspect of your session.

  • ✓Stateful session memory (.forge/session.json)
  • ✓Slash commands: /model, /diff, /privacy, /doctor, /history
  • ✓Unified prompt with interactive command safety confirmation
🛡️
forge --privacy local-only

Zero-Leak Local Privacy & Hybrid Edge Mesh

Absolute protection for proprietary code. Run 100% offline via local Ollama with zero network egress, or tap into high-throughput cloud models (Qwen 2.5 Coder 32B, DeepSeek R1, Llama 4 Scout 131k context) across 300+ edge cities.

  • ✓Strict fail-closed edge rejection for local-only policies
  • ✓100% offline Ollama inference on local GPU/CPU ($0 cost)
  • ✓Sub-500ms TTFT edge routing via Cloudflare Workers AI
🗄️
~/.npxforge/npxforge.sqlite

Local SQLite Audit Ledger & Financial Budget Guards

Enterprise observability and cost control. Every run, prompt, model call duration, and git checkpoint is recorded in a local SQLite ledger, with strict financial spending caps to prevent runaway cloud bills.

  • ✓Persistent SQLite audit trail (forge runs, forge show <id>)
  • ✓Hard USD spending limits per run (--max-cost) and monthly caps
  • ✓PathGuard traversal shield blocking directory escapes
Enterprise System Design

Comprehensive Platform Architecture

Engineered for high autonomy, verifiable test execution, local-first safety, and zero cloud lock-in.

Mode A: CI/CD & Script
forge run <goal>

Autonomous headless execution

Mode B: Developer REPL
forge (Interactive)

Multi-turn pair-programming

Safety & Preflight
PathGuard & Policy
  • Repository stack inspection
  • Path traversal protection
  • Protected file isolation (.env, .git)
  • Spending budget guardrails
Test & Ledger Engine
Self-Healing & SQLite
  • Automated test execution
  • Iterative regression repair loop
  • Audit history in npxforge.sqlite
  • Git diff snapshot checkpoints
Local Engine ($0)
Offline Ollama

100% offline, zero cloud egress

Edge Mesh (<500ms)
Cloudflare Edge AI

Qwen 2.5 Coder, DeepSeek R1, Llama 4 Scout

✓ No Code Retention Policy

Inference prompts are processed strictly in ephemeral memory and discarded immediately upon response streaming. We do not train models on your proprietary code.

✓ Hard Budget & Token Cost Caps

Set hard spending limits per task run with --max-cost and daily/monthly caps to guarantee full financial control and avoid unexpected cloud bills.

✓ Fully Auditable SQLite Ledger

Every single autonomous run, prompt, model decision, token consumption metric, and git checkpoint is recorded in an auditable local SQLite database on your machine.

Client-Side Device Session

My Account & Device Tokens

Manage your active authentication token, inspect live edge gateway connectivity, and monitor quota.

🔑

No Active Device Token Found

Generate a new token for this workstation, or import an existing token if you already generated one on another device.

Generate New Access Token
Token Generator

Generate Gateway Access Token

Create an instant cryptographic HMAC token for your device to authenticate Forge CLI with the Cloud Gateway.

Flexible Price Package Plans

Run fully offline locally with Ollama for $0, or tap into high-throughput cloud models via Cloudflare Workers AI.

Starter

Free Forever
$0/ month

Ideal for solo builders, hobbyists, and offline local development.

  • ✓100% Offline Local Mode (Ollama)
  • ✓200,000 Cloud Tokens / month
  • ✓Qwen 2.5 Coder & Llama 3.2 3B access
  • ✓Multi-turn interactive agent terminal
  • ✓PathGuard & Command safety policies
Most Popular

Developer Pro

5M Tokens
$15/ month

For engineers building real-world projects needing flagship reasoning and coding models.

  • ✓5,000,000 Cloud Tokens / month
  • ✓Qwen 2.5 Coder 32B (Top coding score)
  • ✓DeepSeek R1 32B (Complex logic & math)
  • ✓Llama 4 Scout 17B (131,000 Context Window)
  • ✓Kimi K2.7 Code & Llama 3.3 70B Agent
  • ✓Low-latency edge routing (<500ms TTFT)

Team & Scale

25M Tokens
$49/ month

For development teams needing shared quotas, pooled ledgers, and priority support.

  • ✓25,000,000 Cloud Tokens / month
  • ✓All Models + OpenAI GPT-OSS 120B
  • ✓Multi-device token generation & team ledger
  • ✓High concurrency (300 req/min)
  • ✓Priority 24/7 Slack & Discord Support

Available AI Models & Aliases

Switch models dynamically in your terminal using /model <alias> or arrow keys.

Model NameCategoryShort AliasContext WindowFunction Calling
Qwen 2.5 Coder 32BFlagship CoderCodecoder32,768 tokensNative Tools
DeepSeek R1 Distill Qwen 32BReasoningCode / Reasoningdeepseek, r132,768 tokensNative Tools
Llama 4 Scout 17B MoE131k ContextAgentscout, llama4131,000 tokensNative Tools
Llama 3.3 70B Fast AgentAgentllama3, llama32,768 tokensNative Tools
Kimi K2.7 Code (Moonshot)Codekimi32,768 tokensNative Tools
OpenAI GPT-OSS 120BAgentgpt65,536 tokensNative Tools
Qwen 2.5 Coder 7B (Local)100% OfflineLocal (Ollama)local, qwenLocal ContextLocal Tools
Frequently Asked Questions

Developer Questions & Answers

Everything you need to know about Forge terminal agent, offline security, and cloud edge models.

Npxstack Forge is a complete autonomous software engineering platform that goes far beyond a simple interactive chat terminal. It includes: (1) Headless autonomous task execution ("forge run") for CI/CD and scripts, (2) Stack preflight inspection ("forge inspect") that detects frameworks, build tools, and test suites, (3) Test-driven verification and self-healing repair loops that fix regressions automatically, (4) Interactive pair-programming terminal ("forge") with multi-turn memory, (5) Persistent local SQLite ledger tracking runs and costs, (6) Hard financial budget guards, and (7) Hybrid inference supporting 100% offline Ollama and Cloudflare Workers AI edge models.