codeflow-cli 0.1.3

Advanced AI coding assistant with Cursor AI-style agentic capabilities, semantic search, and intelligent code operations

CodeFlow CLI

A powerful, terminal-first AI coding assistant with advanced agentic capabilities. CodeFlow helps you read, explore, analyze, and improve your codebase with an enhanced chat UI, intelligent tools, and safe, confirmed edits.

🚀 Why CodeFlow?

• Advanced Agent Mode: Enhanced AI capabilities with intelligent tool orchestration
• Stunning terminal UI with rich colors, syntax-highlighting, and interactive panels
• Three powerful modes that fit any workflow:
  • Q&A Mode (read-only): Ask questions about the codebase without making changes
  • Agent Mode (write): Propose and apply changes with diff previews and confirmation
  • Advanced Agent (enhanced): Smart tools, semantic search, code analysis, and intelligent automation
• Smart codebase understanding: Automatic project structure analysis and context awareness
• Semantic search capabilities: Find code by meaning, not just text matching
• Advanced code analysis: Structure analysis, complexity metrics, and issue detection
• Tool execution tracking: Monitor and manage all AI operations with full transparency
• Enhanced file operations: Read, edit, create, and delete files with intelligent assistance
• Real-time collaboration: Switch between modes seamlessly during chat sessions

Install

pip install codeflow-cli

Quick Start

codeflow

On start, pick a mode:

• Q&A Mode (1 or qna) - Read-only questions about your codebase
• Agent Mode (2 or agent) - Propose/apply improvements with confirmation
• Advanced Agent (3 or advanced) - Enhanced AI with smart tools and analysis

Switch modes anytime during chat:

• /qna - Switch to Q&A mode
• /agent - Switch to Agent mode
• /mode <mode_name> - Switch to specified mode

Configuration

Set your Groq API key one of the following ways:

# Recommended: environment variable
export GROQ_API_KEY="your-groq-api-key"

# Or interactively
codeflow configure

# Or via flag
codeflow --api-key "your-groq-api-key"

🛠️ Common Commands

Universal Commands (All Modes)

• /help - Show mode-specific help and available commands
• /model - Change AI model with interactive selection
• /clear - Clear chat history
• /exit - Quit CodeFlow

Q&A & Agent Mode Commands

• /files - List accessible files in workspace
• /scan - Rescan workspace for new files
• /read <file> - Read and preview a file with syntax highlighting
• /workspace - Show workspace information

Agent Mode Commands

• /edit <file> - Propose/apply edits with diff preview and confirmation

🚀 Advanced Agent Commands

• /search <query> - Semantic codebase search by meaning
• /analyze <file> - Analyze code structure, complexity, and quality
• /read <file> - Read file with enhanced analysis
• /edit <file> - Intelligent file editing with AI assistance
• /status - Show comprehensive system status
• /tools - Display all available agentic tools
• /context - Show current workspace context
• /history - Show recent changes and operations
• /shortcuts - Show quick model switching shortcuts

🔄 Quick Model Switching

• /fast, /balanced, /powerful, /ultra - Quick model switches
• /next, /prev - Cycle through available models

📚 Examples

Q&A Mode (Read-Only Analysis)

# Start CodeFlow and select Q&A mode
codeflow
> Select mode: 1 (Q&A Mode)

# Ask questions about your codebase
You: Where is the CLI entry point defined?
AI: The CLI entry point is defined in `groq_agent/cli.py`...

# Read and preview files
/read groq_agent/cli.py

Agent Mode (File Modifications)

# Switch to Agent mode
/agent

# Propose edits with diff preview
/edit groq_agent/enhanced_chat.py
What changes? Improve the prompt styling and add a bottom toolbar.
# Shows diff, asks for confirmation before applying

🚀 Advanced Agent Mode

# Start with Advanced Agent mode
codeflow
> Select mode: 3 (Advanced Agent)

# Semantic search across codebase
/search "user authentication logic"
# Finds relevant code by meaning, not just keywords

# Analyze code structure and quality
/analyze groq_agent/api_client.py
# Shows metrics: complexity, structure, potential issues

# Get comprehensive system status
/status
# Shows workspace info, recent changes, tool usage

# Intelligent file editing
/edit src/main.py
What changes? Add error handling for API calls
# AI understands context and proposes intelligent changes

Quick Model Switching

# Quick switches during any mode
/fast      # Switch to fastest model
/powerful  # Switch to most capable model
/next      # Cycle to next model
/shortcuts # Show all quick commands

Uninstall

pip uninstall codeflow-cli

🎯 Key Features

🤖 Advanced AI Capabilities

• Semantic Understanding: Search code by meaning, not just text
• Context Awareness: AI understands your project structure and recent changes
• Tool Orchestration: Coordinate multiple operations intelligently
• Change Tracking: Monitor all modifications with full history
• Quality Analysis: Automated code structure and complexity analysis

🎨 Enhanced User Experience

• Rich Terminal UI: Beautiful panels, tables, and syntax highlighting
• Interactive Model Selection: Easy model switching with arrow key navigation
• Command Auto-completion: Intelligent slash command suggestions
• Real-time Status: Progress indicators and system status updates
• Mode Flexibility: Seamless switching between Q&A, Agent, and Agentic modes

🔧 Smart Development Tools

• Project Structure Analysis: Automatic detection of project type and architecture
• File Operations: Enhanced read, edit, create, and delete with AI assistance
• Diff Previews: Clear visualization of changes before applying
• Workspace Awareness: Intelligent file filtering and context building
• Error Recovery: Robust error handling with helpful suggestions

🚨 Troubleshooting

• Command not found: Ensure your Python scripts directory (e.g., ~/.local/bin or /opt/anaconda3/bin) is on your PATH
• API key issues: Export GROQ_API_KEY or run codeflow configure
• Model selection problems: Try using arrow keys, Tab, or Enter in the model selector
• Advanced Agent mode not available: Update to the latest version with pip install --upgrade codeflow-cli
• Publishing guidance (maintainers): See INSTALL.md

📄 License

MIT License - Created by TM NABEEL @tmnabeel30

---

CodeFlow CLI - Bringing advanced AI capabilities to your terminal 🚀