whatisgithub

What is openwar?

pythonluvr/openwar — explained in plain English

Analysis updated 2026-05-18

2TypeScriptAudience · developerComplexity · 3/5LicenseSetup · easy

In one sentence

A behavior framework and runtime that makes AI coding agents confirm plans, pause before risky actions, and stop cleanly when stuck.

Mindmap

mindmap
  root((OpenWar))
    What it does
      Confirms plans first
      Gates destructive actions
      Stops cleanly when blocked
    Tech stack
      TypeScript runtime
      CLI adapters
      System prompt file
    Use cases
      Agent guardrails
      Multi-agent orchestration
      Consistent tone
    Audience
      Developers
      Agent operators
    Setup
      Zero-setup system prompt
      Optional CLI runtime

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add guardrails to an existing AI coding agent so it confirms plans before acting.

USE CASE 2

Stop an agent from performing destructive actions without explicit approval.

USE CASE 3

Coordinate multiple AI agents working together with defined roles and budgets.

USE CASE 4

Enforce a consistent, less sycophantic communication style from an AI agent.

What is it built with?

TypeScriptNode.jsCLI

How does it compare?

pythonluvr/openwararashthr/hugo-flowargeneau12e/kairos-tx
Stars222
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderatehard
Complexity3/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Can be tried instantly as a pasted system prompt with no install, the full runtime needs Node and optionally an API key.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

So what is it?

OpenWar is a set of rules, and an optional companion program, designed to change how an AI agent behaves rather than how smart it is. The problem it tries to fix is that AI agents often jump straight into a task, skip asking clarifying questions, and try risky actions without pausing to check first. OpenWar replaces those habits with the pattern of a careful, experienced colleague who confirms the plan before acting. The simplest way to use it is a single markdown file that gets pasted into any agent's system prompt, taking effect right away with no installation needed. For stronger enforcement, there is also a runtime, written in TypeScript, that watches what the agent outputs at each step and catches the moments when it tries to skip a required rule. Work happens in phases. Before anything starts, the agent has to write a confirmation summary covering the objective, what it will deliver, constraints, tools it needs, and anything unclear, and execution cannot begin until a person accepts that summary. While working, the agent proceeds step by step, and if it plans to do something destructive or outside what was agreed, it has to stop and explicitly ask for permission first. If the agent gets stuck, the session pauses and saves its state so the work can pick back up later. At the end, it produces a short completion report. OpenWar is meant to sit on top of tools people already use, such as Claude Code, Codex CLI, Gemini CLI, aider, or a cloud AI service accessed with your own API key, rather than replacing any of them. It does not make the underlying model smarter, it just adds guardrails around how that model is allowed to behave. It can be tried immediately with no API key at all, either as a plain system prompt or by validating a task brief with no model call involved.

Copy-paste prompts

Prompt 1
Paste openwar.md into my CLAUDE.md file and explain what behavior changes I should expect.
Prompt 2
Help me run a brief through the OpenWar CLI using the cli-bridge adapter with Claude Code.
Prompt 3
Show me how to validate a brief file with npx @pythonluvr/openwar validate, with no model call.
Prompt 4
Explain how OpenWar's phase system (confirmation, execution, blocked, destructive, completion) works.

Frequently asked questions

What is openwar?

A behavior framework and runtime that makes AI coding agents confirm plans, pause before risky actions, and stop cleanly when stuck.

What language is openwar written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, CLI.

What license does openwar use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is openwar to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is openwar for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.