git404hub

what is sol-governed-codex fr?

busybee3333/sol-governed-codex — explained in plain English

Analysis updated 2026-05-18

24ShellAudience · developerComplexity · 3/5LicenseSetup · moderate

tl;dr

A Codex plugin that splits coding work across cheap and expensive AI agents to cut model costs while keeping review quality on risky changes.

vibe map

mindmap
  root((Sol-Governed Codex))
    What it does
      Routes tasks by cost
      Reviews risky changes
      Gives PASS REVISE verdicts
    Tech stack
      Shell scripts
      Python
      OpenAI Codex
    Use cases
      Cut AI model costs
      Gate risky diffs
      Multi agent workflow
    Audience
      Codex developers
      Cost conscious teams
    Setup
      Git and Bash
      Python 3.11
      Plugin marketplace

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 make with this?

VIBE 1

Route routine mechanical edits to a cheap AI worker instead of a premium model.

VIBE 2

Get a structured PASS or REVISE verdict before merging a risky code change.

VIBE 3

Set up a repeatable multi-agent coding workflow inside OpenAI Codex.

VIBE 4

Reduce AI API spend on a team that already uses Codex heavily.

what's the stack?

ShellPythonOpenAI CodexTOML

how it stacks up fr

busybee3333/sol-governed-codexalexwortega/claude-ml-intern-skillclefspear/starcommand
Stars242424
LanguageShellShellShell
Setup difficultymoderatemoderateeasy
Complexity3/54/52/5
Audiencedeveloperresearcherdeveloper

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

how do i run it?

Difficulty · moderate time til it works · 30min

Requires an existing OpenAI Codex installation plus Git, Bash, and Python 3.11 or later.

in plain english

Sol-Governed Codex is a toolkit that plugs into OpenAI Codex to organize how multiple AI agents work together on coding tasks, while keeping an eye on cost. Instead of using the most expensive, most capable AI model for every single edit, it splits work across three roles and only calls in a stronger reviewer when the task actually needs one. The three roles are Terra, Luna, and Sol. Terra sits at the root and owns requirements, integration, and talking to the developer. Luna is a low-cost worker meant for mechanical, well-defined edits and tests. Sol is a bounded advisor brought in only for higher-stakes moments, such as reviewing a risky plan, architecture decisions, security, billing, or destructive operations, and it gives back a clear verdict of PASS, REVISE, or BLOCKED along with supporting evidence rather than a vague thumbs up. Setup requires Git, Bash, Python 3.11 or later, and an existing OpenAI Codex installation. It can be installed either through the Codex plugin marketplace with a couple of commands, or by cloning the repository directly and running an installer script that copies the skill files and agent profiles into your Codex home folder. The installer includes safety checks: it will not silently overwrite files you have modified unless you explicitly force it, and it refuses to replace an existing AGENTS.md file in your project without your review. Once installed, a typical workflow looks like starting Codex with one of two provided profiles, giving the root agent a clear goal and acceptance criteria, letting Luna and Terra handle the actual work at their appropriate skill levels, and calling on Sol only for the moments that matter, like checking a diff before something risky ships. There is a validation script to confirm the setup is working correctly without spending on an actual model call. The project is MIT licensed and includes automated validation checks visible in its GitHub Actions badge.

prompts (copy fr)

prompt 1
Help me install sol-governed-codex into my Codex home using the direct install script.
prompt 2
Explain the difference between the Terra, Luna, and Sol roles in this workflow.
prompt 3
Walk me through validating my sol-governed-codex setup without spending a model call.
prompt 4
How do I add the governed-workflow contract to an existing project with this tool?

Frequently asked questions

what is sol-governed-codex fr?

A Codex plugin that splits coding work across cheap and expensive AI agents to cut model costs while keeping review quality on risky changes.

What language is sol-governed-codex written in?

Mainly Shell. The stack also includes Shell, Python, OpenAI Codex.

How hard is sol-governed-codex to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is sol-governed-codex for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.