open-codex  by codingmoh

CLI tool for local command-line AI assistance

Created 5 months ago
622 stars

Top 53.1% on SourcePulse

GitHubView on GitHub
1 Expert Loves This Project
Project Summary

Open Codex is a command-line AI assistant that translates natural language into shell commands, inspired by OpenAI Codex. It targets developers and power users seeking a local, privacy-focused alternative to cloud-based AI coding assistants, enabling efficient terminal operations without API keys or external dependencies.

How It Works

The assistant leverages local, open-source language models, currently supporting phi-4-mini, to process natural language prompts and generate corresponding shell commands. This local-first approach ensures data privacy and offline functionality, while the one-shot interaction mode provides a direct natural language-to-command execution flow with user confirmation.

Quick Start & Requirements

  • Install: brew tap codingmoh/open-codex && brew install open-codex (macOS), or pipx install open-codex (cross-platform).
  • Prerequisites: Python.
  • Setup: Minimal, as models run locally.
  • Docs: https://github.com/codingmoh/open-codex

Highlighted Details

  • Natural Language to Shell Command conversion.
  • Works on macOS, Linux, and Windows.
  • One-shot interaction mode with confirmation before execution.
  • Colored terminal output for readability.

Maintenance & Community

The project is maintained by codingmoh. Contributions and ideas are welcomed via pull requests and issues.

Licensing & Compatibility

Licensed under the MIT License, permitting commercial use and integration with closed-source projects.

Limitations & Caveats

Currently supports only the phi-4-mini model, with interactive and context-aware modes planned for future releases. Function-calling and support for additional OSS models are also under development.

Health Check
Last Commit

2 months ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
32 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.