Is Smoke Monkey an AI model?

No. Smoke Monkey is not an LLM. It is an embeddable, framework-agnostic runtime that turns LLMs (NVIDIA, Gemini, OpenAI, Claude, Ollama) into autonomous engineering agents capable of multi-step planning, calling tools, editing files, and running test loops with zero runtime dependencies.

Do I need a database (Postgres, SQLite, or Redis)?

No database is required. State is persisted through lean session files on disk, or you can plug in your own custom storage adapter. You can deploy it as a CLI, a desktop app, or inside a serverless function without provisioning a database.

How does human-in-the-loop permission gating work?

Smoke Monkey comes with three permission policies: allow-all, deny-all, and ask-default (or a custom function resolver). When a sensitive tool like edit_file or run_command is called under "ask", the runtime emits a permission.required event, pausing execution until your code or UI calls agent.resolvePermission(id, "allow" | "deny").

How does the Model Context Protocol (MCP) server work?

Smoke Monkey ships an official stdio MCP server in smoke-monkey-harness-mcp. Point Claude Code, Cursor, Codex, or opencode at it using npx -y smoke-monkey-harness-mcp to let other AI tools plan, scaffold, verify, and run agents using Smoke Monkey automatically.

What are SKILL.md skills and how do they prevent context bloat?

Skills are directories containing a SKILL.md workflow file. The system prompt only includes a one-line catalog of available skills. When a task requires specialized expertise (e.g. frontend-ui-engineering, test-driven-development, or security-hardening), the agent calls use_skill to load instructions just-in-time, saving thousands of tokens.

What is an AI Agent Harness?

An AI agent harness is the execution environment that bridges raw Large Language Models (LLMs) to real-world software engineering capabilities. While an LLM generates tokens, an AI harness manages deterministic phase loops (explore, plan, edit, verify, recover), tool execution sandboxing, token budget compaction, and safety gates needed for autonomous problem-solving.

What makes Smoke Monkey an Agentic AI runtime rather than a simple wrapper?

Unlike basic prompt-response chains, Smoke Monkey implements true agentic AI architecture: a deterministic 6-phase state machine with automatic failure recovery, runaway loop guards, 24 built-in developer tools, dynamic subcontext isolation, and interactive human-in-the-loop permission pauses.

Is Smoke Monkey Harness 100% Open Source AI?

Yes. Smoke Monkey Harness is 100% open source under the permissive MIT license with zero runtime dependencies. There is no telemetry lock-in, no mandatory cloud backend, and no database requirement—giving engineering teams complete sovereignty over their agent code.

What Agent APIs does Smoke Monkey Harness provide?

Smoke Monkey provides composable TypeScript Agent APIs: createAgent() for initialization, agent.run() for multi-turn execution, agent.on() for fine-grained lifecycle and streaming events, agent.resolvePermission() for interactive human authorization, subcontext switching APIs, and stdio Model Context Protocol (MCP) server endpoints.

Can I run completely offline without API keys?

Yes! Smoke Monkey natively supports Ollama out of the box. Set provider: "ollama" and model: "qwen3:8b" with workspacePath, and the agent will run locally on your machine with zero external network requests.

Smoke Monkey vs CrewAI

Python Multi-Agent FrameworkUpdated: October 2026

CrewAI TypeScript Alternative: Autonomous Agent Loop Without Python

CrewAI is tightly bound to the Python ecosystem, making it awkward and inefficient for TypeScript, Next.js, and Node.js teams to adopt. Smoke Monkey Harness delivers autonomous agent loops, subcontext switching, and tool sandboxing in native TypeScript with zero runtime overhead.

Comparative Benchmark: Smoke Monkey Harness TypeScript vs CrewAI

|Verified for Node.js 18+ & Bun|100% MIT Open Source

The Executive Verdict (Quick Answer)

Why choose Smoke Monkey over CrewAI? If your stack is built on TypeScript, React, and Node.js, Smoke Monkey Harness lets you build production-grade autonomous agents natively without spinning up secondary Python runtimes or wrestling with conda environments.

Why Developers Switch from CrewAI to Smoke Monkey

100% Native TypeScript: No Python virtual environments, pip packages, or subprocess bridges.

Surgical AST Code Editing: Edit codebases with chunk replacement rather than basic regex search/replace.

Subcontext Isolation: Spin up isolated worker subcontexts with bounded memory trees without complex orchestrator overhead.

Direct MCP Integration: Connect to developer IDEs like Cursor and Claude Code out of the box.

Permissive MIT License: Truly open source with zero telemetry or enterprise upsells.

Detailed Feature-by-Feature Matrix

Direct side-by-side comparison of core runtime capabilities and architectural trade-offs.

Capability	Smoke Monkey Harness	CrewAI	Key Architectural Difference
Language & Ecosystem	✅ 100% Strict TypeScript / JavaScript	❌ Python 3.10+ only (no official TS runtime)	Integrates natively into Next.js, Express, NestJS, and Electron.
Installation Complexity	✅ `npm install smoke-monkey-harness` (instant)	⚠️ Python venv, poetry, PyTorch/ChromaDB dependencies	Zero native C/C++ compilation hurdles.
Human-in-the-Loop Pauses	✅ Interactive UI events & permission gates	⚠️ CLI console inputs or complex custom callbacks	Seamlessly wire approvals to modern web chat interfaces.

Code Implementation Comparison

Configuring an Autonomous Engineering Agent

Smoke Monkey (TypeScript)Zero Dependencies

agent-ts.tstypescript

1import { createAgent } from 'smoke-monkey-harness';
2
3// Native TypeScript with zero external dependencies
4const agent = createAgent({
5  provider: 'nvidia',
6  model: 'nvidia/nemotron-3-super-120b-a12b',
7  workspacePath: './project',
8  autoApprove: true,
9});
10
11await agent.run('Audit dependencies in package.json and upgrade outdated ones');

CrewAIPython Ecosystem Only

crewai_agent.pypython

1from crewai import Agent, Task, Crew, Process
2
3# Requires Python runtime, LangChain dependencies, and complex setup
4developer = Agent(
5    role='Software Engineer',
6    goal='Audit dependencies',
7    backstory='Senior engineer specializing in package security',
8    verbose=True
9)
10
11task = Task(
12    description='Audit dependencies in package.json',
13    expected_output='Updated package.json',
14    agent=developer
15)
16
17crew = Crew(agents=[developer], tasks=[task], process=Process.sequential)
18result = crew.kickoff()

Architecture Note: Smoke Monkey replaces verbose roleplay backstories and multi-agent bureaucracy with focused, practical engineering execution.

Why Engineering Agents Don’t Need Roleplay Backstories

Frameworks like CrewAI rely heavily on simulated agent personas (e.g., "Senior Python Architect with 20 years experience"). While entertaining for demos, persona roleplay consumes precious context window tokens and degrades prompt adherence. Smoke Monkey focuses purely on task decomposition, tool execution precision, and automated verification loops.

Frequently Asked Questions

Questions Developers Ask About CrewAI Alternatives

Q:Can Smoke Monkey run multi-agent workflows like CrewAI?

Yes. Smoke Monkey supports Subcontexts, allowing a primary agent to spawn focused sub-agents with dedicated workspace scopes and isolated context windows.

Q:Can I use local models with Smoke Monkey like CrewAI does with Ollama?

Yes! Smoke Monkey natively integrates with Ollama. Set provider: "ollama" and model: "qwen3:8b" to run 100% locally and offline.

Switch to Smoke Monkey Harness Today

Build autonomous coding agents with zero runtime dependencies, deterministic 6-phase loops, and Model Context Protocol (MCP) in pure TypeScript.

npm install smoke-monkey-harness

CrewAI TypeScript Alternative: Autonomous Agent Loop Without Python

Why Developers Switch from CrewAI to Smoke Monkey

Detailed Feature-by-Feature Matrix

Code Implementation Comparison

Why Engineering Agents Don’t Need Roleplay Backstories

Questions Developers Ask About CrewAI Alternatives

Q:Can Smoke Monkey run multi-agent workflows like CrewAI?

Q:Can I use local models with Smoke Monkey like CrewAI does with Ollama?

Related Solutions & Topics

Subcontexts & Memory in AI Agents: Isolating Contexts for Multi-Turn Reasoning

Run Autonomous Coding Agents 100% Offline with Ollama & Local LLMs

Free & Open Source AI Agent Framework: 100% MIT Licensed TypeScript Harness

Switch to Smoke Monkey Harness Today