CLI with OSS LLM integration
Project description
Open Codex
Open Codex CLI
Lightweight coding agent that runs in your terminal
brew install brew tap codingmoh/open-codex
brew install open-codex
Open Codex is a fully open-source command-line AI assistant inspired by OpenAI Codex, supporting local language models like phi-4-mini.
No API key is required. Everything runs locally.
Supports:
- One-shot mode:
open-codex "list all folders"-> returns shell command - 🧠 Local-only execution using supported OS models (currently
phi-4-mini)
✨ Features
- Natural Language to Shell Command (via local models)
- Works on macOS, Linux, and Windows (Python-based)
- Confirmation before execution
- Add to clipboard / abort / execute prompt
- One-shot interaction mode (interactive and function-calling coming soon)
- Colored terminal output for better readability
🧱 Future Plans
- Interactive, context aware mode
- Fancy TUI with
textualorrich - Add support for additional OSS Models
- Full interactive chat mode
- Function-calling support
- Voice input via Whisper
- Command history and undo
- Plugin system for workflows
📦 Installation
🔹 Option 1: Install via Homebrew (Recommended for MacOS)
brew tap codingmoh/open-codex
brew install open-codex
🔹 Option 2: Install via pipx (cross-platform)
pipx install open-codex
🔹 Option 3: Clone & Install locally
git clone https://github.com/codingmoh/open-codex.git
cd open_codex
pip install .
Once installed, you can use the open-codex CLI globally.
🚀 Usage
One-shot mode
open-codex "untar file abc.tar"
✅ Codex suggests a shell command
✅ Asks for confirmation / add to clipboard / abort
✅ Executes if approved
🛡️ Security Notice
All models run locally. Commands are only executed after explicit approval.
🧑💻 Contributing
PRs welcome! Ideas, issues, improvements — all appreciated.
📝 License
MIT
❤️ Built with love and caffeine by codingmoh.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file open_codex-0.1.10-py3-none-any.whl.
File metadata
- Download URL: open_codex-0.1.10-py3-none-any.whl
- Upload date:
- Size: 6.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e4cea21a8eee4315d62d9632f2e0c98a16360d16b75ae492d3b243ffdeaa1f37
|
|
| MD5 |
861ceb42516e5dc19dc78bf07679c677
|
|
| BLAKE2b-256 |
cd07a57e740b44e0e82a1099e81ee7673c4e3debbcbd72e33baeb5ec3756810c
|