openagentic-ai 0.2.1

Powerful claude code open source alternative. AI coding assistant powered by Abdel-Hazim Lawani — use it in any folder

openagentic-ai

Powerful open-source alternative to Claude Code. An AI coding assistant that works in any folder, powered by your own API keys.

pip install openagentic-ai

---

What it does

open-code is a terminal-based AI agent that reads, writes, and edits your code, runs shell commands, searches the web, and navigates your entire codebase — all from a single command.

cd my-project
open-code "add a dark mode toggle to the navbar"

---

Features

• Multi-provider — bring your own API key (Together, Groq, Mistral, Gemini, OpenRouter)
• Full file access — create, read, edit, delete files and directories
• Shell execution — run any command directly in your project folder
• Codebase search — glob patterns, regex grep across all files
• Internet search — built-in Tavily-powered web research
• Three agent modes — ask, auto, plan
• Session memory — context is persisted and trimmed intelligently across turns
• Rich TUI — beautiful terminal interface with live streaming output

---

Quick start

1. Install

pip install openagentic-ai

2. Configure your API key

Create a .env file in your project folder (or home directory):

# Pick one provider — the first key found is used

TOGETHER_API_KEY=your_key_here
# GROQ_API_KEY=your_key_here
# MISTRAL_API_KEY=your_key_here
# GEMINI_API_KEY=your_key_here
# OPENROUTER_API_KEY=your_key_here

Get a free key:

• Together AI
• Groq
• Mistral
• Gemini
• OpenRouter

3. Run

cd your-project
open-code

Or pass a query directly:

open-code "refactor the auth module to use JWT"
open-code --mode plan "migrate the database to PostgreSQL"

---

Supported providers & default models

Provider	Default model
Together AI	Qwen/Qwen3-Coder-Next-FP8
Groq	moonshotai/kimi-k2-instruct
Mistral	codestral-latest
Gemini	gemini-2.5-pro-preview-03-25
OpenRouter	kwaipilot/kat-coder-pro-v2

Override the model for any provider:

TOGETHER_MODEL=meta-llama/Llama-3-70b-chat-hf
GROQ_MODEL=llama3-70b-8192
GEMINI_MODEL=gemini-2.0-flash

---

Agent modes

Mode	Behavior
auto (default)	Plans, edits files, and runs commands autonomously
ask	Read-only — answers questions and explains code, no file changes
plan	Produces a step-by-step plan and waits for your approval before acting

open-code --mode ask "how does the authentication flow work?"
open-code --mode plan "add Stripe payment integration"

---

Available tools

The agent has access to:

Tool	Description
create_file	Create a new file with full content
read_file	Read file contents (with offset/limit)
edit_file	Precise string replacement in a file
delete_file	Delete a file
view_file	Quick file preview
list_dir	List directory contents
create_dir / delete_dir	Directory management
glob_files	Find files by pattern (e.g. **/*.ts)
grep_codebase	Regex search across all files
grep_file	Regex search in a single file
run_command	Execute shell commands
internet_search	Web search via Tavily

---

Environment variables

# Provider API keys (first found is used)
TOGETHER_API_KEY=
GROQ_API_KEY=
MISTRAL_API_KEY=
GEMINI_API_KEY=
OPENROUTER_API_KEY=

# Optional: override default model per provider
TOGETHER_MODEL=
GROQ_MODEL=
MISTRAL_MODEL=
GEMINI_MODEL=
OPENROUTER_MODEL=

# Optional: show full LLM context on each call (debug)
OPENCODE_SHOW_CONTEXT=1

# Optional: Tavily key for internet search
TAVILY_API_KEY=

---

Requirements

• Python >= 3.10
• A valid API key for at least one supported provider

---

License

MIT — built by Abdel-Hazim Lawani