⭐ Star on GitHub • 📚 Documentation

For beta token must be provided manually, it is an access token from "auth.json" from your codex folder.

export TEST_OPENAI_TOKEN=your-codex-token

./flow

How does it work?

Flow is a complete re-implementation of Claude Code's terminal interface, purpose-built for OpenAI's GPT-5 Codex. It's not a wrapper or fork—every detail from SSE streaming to tool orchestration is engineered from the ground up for Codex's reasoning models. You get the same conversational, agentic AI coding experience, but optimized for Codex.

🔥 Why Flow?

• 🎯 Claude Code's interface for Codex - Same conversational flow, streaming responses, and tool calling
• 🧠 Transparent reasoning - See Codex's reasoning summaries as it works through problems
• ⚡ Single binary - One file to run anywhere. No runtime, no dependencies, no setup
• 🔧 Agentic tools - File pattern matching, code analysis, and more (CC-style tools)
• 🎨 Terminal-native - Beautiful markdown rendering, syntax highlighting, thinking indicators
• 🚀 Blazing fast - Built on Bun with real-time SSE streaming

📦 Current Status

Currently supports:

• ✅ GPT-5 Codex (high, medium, and low reasoning tiers)
• ✅ Tool calling (Claude Code-style tools)
• ✅ Single binary compiled with Bun

Coming soon:

• 🔄 MCP (Model Context Protocol) - Plugin system for extensible tools
• 🎣 Hooks - Customize behavior with pre/post execution hooks
• 🔌 Multi-provider support - Beyond Codex

🏠 Who We Are

From the creators of Happy Coder ⭐ 2.5k - we're engineers who believe in building tools that scratch our own itch. Flow was born from wanting Claude Code's polished interface with Codex's cutting-edge reasoning. We built it from scratch, shared it with the community, and now you can use it too.

📚 Documentation & Contributing

Flow is experimental and open source. Want to contribute? The codebase is clean, well-documented, and designed for extensibility.

# Clone and build
git clone https://github.com/slopus/flow
cd flow
bun install
bun run dev

Questions? Issues? Contributions? Open an issue or PR.

License

MIT License - see LICENSE for details.