CodexPotter
| Entity Passport | |
| Registry ID | gh-tool--breezewish--codexpotter |
| License | Apache-2.0 |
| Provider | github |
Cite this tool
Academic & Research Attribution
@misc{gh_tool__breezewish__codexpotter,
author = {breezewish},
title = {CodexPotter Tool},
year = {2026},
howpublished = {\url{https://free2aitools.com/tool/gh-tool--breezewish--codexpotter}},
note = {Accessed via Free2AITools Knowledge Fortress}
} ๐ฌTechnical Deep Dive
Full Specifications [+]โพ
Quick Commands
pip install codexpotter โ๏ธ Nexus Index V2.0
๐ฌ Index Insight
FNI V2.0 for CodexPotter: Semantic (S:50), Authority (A:0), Popularity (P:62), Recency (R:100), Quality (Q:50).
Verification Authority
๐ Specs
- Language
- Python
- License
- Apache-2.0
- Version
- 1.0.0
Usage documentation not yet indexed for this tool.
Technical Documentation
๐ก Why CodexPotter
CodexPotter continuously reconciles code base toward your instructed state (Ralph Wiggum pattern):
- ๐ค Codex-first โ Codex subscription is all you need; no extra LLM needed.
- ๐งญ Auto-review / reconcile โ Review and polish multi rounds until fully aligned with your instruction.
- ๐ฆ Clean-room โ Use clean context in each round, avoid context poisoning, maximize IQ.
- ๐ฏ Attention is all you need โ Keep you focused on crafting tasks, instead of cleaning up unfinished work.
- ๐ Never worse than Codex โ Drive Codex, nothing more; no business prompts which may not suit you.
- ๐งฉ Seamless integration โ AGENTS.md, skills & MCPs just workโข ; opt in to improve plan / review.
- ๐ง File system as memory โ Store instructions in files to resist compaction and preserve all details.
- ๐ชถ Tiny footprint โ Use <1k tokens, ensuring LLM context fully serves your business logic.
- ๐ Built-in knowledge base โ Keep a local KB as index so Codex learns project fast in clean contexts.
๐ How does it work
๐๐ถ๐ผ๐น ๐ท๐น๐ถ๐ด๐ท๐ป:
๐๐ช๐ฎ๐ฑ๐ญ๐ช๐ง๐บ ๐ต๐ฉ๐ฆ ๐ฒ๐ถ๐ฆ๐ณ๐บ ๐ฆ๐ฏ๐จ๐ช๐ฏ๐ฆ ๐ฃ๐บ ๐ง๐ฐ๐ญ๐ญ๐ฐ๐ธ๐ช๐ฏ๐จ ...
โ
โ
codex: Work or review according to MAIN.md โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โผ
โโโโโโโโโโโดโโโโโโโโโโ โโโโโโโโโโโโผโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโ
โ CodexPotter โ โ codex โโโโโโโโบโ MAIN.md โ
โโโโโโโโโโโฒโโโโโโโโโโ โโโโโโโโโโโโฌโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโ
โ โ
โ Work finished โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โจ What's New
- May 01, 2026: We now have a V2 version for Codex Desktop users! Checkout v2 branch (experimental) ๐
โก๏ธ Getting started
1. Prerequisites: ensure you have codex CLI locally. CodexPotter drives your local codex to perform tasks.
2. Install CodexPotter via npm or bun:
# Install via npm
npm install -g codex-potter
# Install via bun
bun install -g codex-potter
3. Run: Start CodexPotter in your project directory, just like Codex:
# --yolo is recommended to be fully autonomous
codex-potter --yolo
โ ๏ธ Note: Unlike Codex, every follow up prompt turns into a new task, not sharing previous contexts. Assign tasks to CodexPotter, instead of chat with it.
โ ๏ธ Note: CodexPotter is not a replacement for codex, because CodexPotter is a loop executor โ it executes tasks instead of chatting with you. See below for details.
Tips
Prompt Examples
โ tasks with clear goals or scopes:
- "port upstream codex's /resume into this project, keep code aligned"
โ persist results to review in later rounds:
- "create a design doc for ... in DESIGN.md"
โ interactive tasks with human feedback loops:
CodexPotter is not suitable for such tasks, use codex instead:
- Front-end development with human UI feedback
- Question-answering
- Brainstorming sessions
Howto
Ask followup questions in codex
Just pass the project file to codex, like:
based on .codexpotter/projects/2026/03/18/1/MAIN.md,
please explain more about the root cause of the issue
Plan and execute
Simpliy queue two tasks in CodexPotter, one is plan, one is implement, CodexPotter will execute one by one, for example:
Task prompt 1 (CodexPotter):
Analyze the codebase, research and design a solution for introducing subscription system.
Output plan to docs/subscription_design.md.
Your solution should meet the following requirements: ...
Do not implement the plan, just design a good and simple solution.
โ Your existing facility to write good plans will be utilized, including skills, plan doc principles in AGENTS.md, etc. Writing plan to a file is CRITICAL so that the plan can be iterated multiple rounds and task 2 can pick it up.
Task prompt 2 (CodexPotter):
Implement according to docs/subscription_design.md
Make sure all user journeys are properly covered by e2e tests and pass.
If you even don't know what you are designing for, just discuss with codex to carry out a basic plan first, then use CodexPotter to continously polish and implement it.
Configuration
Other Features
--xmodel(experimental): Use gpt-5.2 first, then use gpt-5.5 to cross review gpt-5.2's work in later rounds. In clear coding tasks this may produce better results than only using gpt-5.2 or gpt-5.5./yolo: Toggle whether YOLO (no sandbox) is enabled by default for all sessions./listorctrl+l: View all projects (tasks) and their results.
Roadmap
- Skill popup
- Resume (history replay + continue iterating)
- Better handling of stream disconnect / similar network issues
- Agent-call friendly (non-interactive exec and resume)
- Interoperability with codex CLI sessions (for follow-up prompts)
- Better plan / user selection support
- Better sandbox support
Development
# Formatting
cargo fmt
# Lints
cargo clippy
# Tests
cargo nextest run
# Build
cargo build
Community & License
- This project is community-driven fork of openai/codex repository, licensed under the same Apache-2.0 License.
๐ Quick Start
# Install via npm
npm install -g codex-potter
AI Summary: Based on GitHub metadata. Not a recommendation.
๐ก๏ธ Tool Transparency Report
Technical metadata sourced from upstream repositories.
๐ Identity & Source
- id
- gh-tool--breezewish--codexpotter
- slug
- breezewish--codexpotter
- source
- github
- author
- breezewish
- license
- Apache-2.0
- tags
- codex, codex-cli, gpt, openai, ralph, ralph-loop, ralph-wiggum, rust
โ๏ธ Technical Specs
- architecture
- null
- params billions
- null
- context length
- null
- pipeline tag
- other
๐ Engagement & Metrics
- downloads
- 0
- stars
- 0
- forks
- 0
Data indexed from public sources. Updated daily.