aiflow-cli
Advanced tools
Intelligent AI Assistant with Smart Model Routing
Created by DavidFon (ε―εΏδΌ)
Hi! I'm DavidFon, a full-stack developer who got tired of expensive AI bills. AiFlow was born from my personal frustration with paying $300+/month for AI APIs when most tasks could be handled by cheaper models.
This repository contains the AiFlow CLI, an intelligent AI assistant that helps developers save 75-85% on AI costs through smart model routing while maintaining high-quality results.
Why AiFlow?
With AiFlow CLI you can:
Prerequisites: Ensure you have Node.js version 18 or higher installed.
Run the CLI: Execute the following command in your terminal:
npx aiflow-cli
Or install it with:
npm install -g aiflow-cli
aiflow
Proxy Settings (v1.2.181+): AiFlow now runs without proxy by default. If you need proxy support:
# Use built-in proxy
prox aiflow
# Use custom proxy
export AIFLOW_PROXY=http://your-proxy:8080
prox aiflow
Pick a color theme
Configure your AI providers: AiFlow supports multiple AI providers for smart routing. Configure your preferred models and API keys.
You are now ready to use AiFlow CLI with intelligent cost optimization!
"Every developer deserves access to powerful AI tools without breaking the bank" - DavidFon
AiFlow supports multiple AI providers for optimal cost-performance routing:
For detailed configuration, see the authentication guide.
Once AiFlow CLI is running, you can start leveraging intelligent AI routing from your shell.
You can start a project from a new directory:
cd new-project/
aiflow
> Write me a Discord bot that answers questions using a FAQ.md file I will provide
Or work with an existing project:
cd your-project
aiflow
> Give me a summary of all of the changes that went in yesterday
With proxy (if needed):
cd your-project
prox aiflow
> Help me analyze this codebase and suggest improvements
Head over to the troubleshooting guide if you're having issues.
AiFlow CLI includes comprehensive cost tracking and optimization tools to help you manage AI expenses:
# View current cost status
aiflow cost status
# Compare costs between models
aiflow cost compare gemini-1.5-flash gpt-4o-mini deepseek-chat
# Get model recommendations for your use case
aiflow cost recommend --scenario coding
# Calculate costs for specific usage
aiflow cost calc gemini-1.5-flash
# Export cost data for analysis
aiflow cost export --format csv
Important Change (v1.2.181+): AiFlow CLI has updated its proxy handling for better flexibility and performance.
If you're behind a corporate firewall or need proxy access:
# Method 1: Use built-in proxy command
prox aiflow
# Method 2: Set custom proxy and use prox command
export AIFLOW_PROXY=http://your-proxy-server:8080
prox aiflow
# Method 3: One-time custom proxy usage
AIFLOW_PROXY=http://corporate-proxy:3128 prox aiflow
| Command | Description |
|---|---|
aiflow | Run without proxy (default) |
prox aiflow | Run with proxy support |
AIFLOW_PROXY=<url> prox aiflow | Run with custom proxy |
If you were using AiFlow v1.2.180 or earlier:
prox aiflow when proxy is neededAiFlow CLI automatically saves your conversation history to .aiflow/session.json in your project directory. This allows you to:
/clear command to completely reset your session, including deleting saved conversation filesNote: The .aiflow directory should be added to your .gitignore to avoid committing conversation history to version control.
AiFlow CLI features fully restored MCP support, enabling powerful integrations with external tools and services through the Model Context Protocol. MCP allows AiFlow to extend its capabilities by connecting to various servers and tools.
AiFlow provides comprehensive MCP configuration management through built-in commands:
# Edit user-level MCP configuration (opens in external editor)
/mcp edit user
# Edit workspace-level MCP configuration
/mcp edit workspace
# Display current MCP configuration information
/mcp info
# View MCP configuration template and examples
/mcp template
# Validate MCP configuration files
/mcp validate
MCP configuration files are stored in the following locations:
~/.aiflow/mcp-config.json - Global settings applied to all projects./.aiflow/mcp-config.json - Project-specific settings that override user-level config/mcp template command/mcp template/mcp edit user or /mcp edit workspace/mcp validate/mcp infoMCP integration allows AiFlow to seamlessly work with external systems, databases, APIs, and tools, significantly expanding its capabilities beyond basic AI interactions.
AiFlow CLI features a powerful Agent system with 13 specialized AI assistants:
# List all available agents
/agents list
# Get agent details
/agents info architect-agent
# Search for agents
/agents search security
# Smart agent recommendation
/smart-agent Help me design a microservice architecture
Learn more in the Agent System Documentation.
Start by cding into an existing or newly-cloned repository and running aiflow.
> Describe the main pieces of this system's architecture.
> What security mechanisms are in place?
> Implement a first draft for GitHub issue #123.
> Help me migrate this codebase to the latest version of Java. Start with a plan.
With restored MCP (Model Context Protocol) support, use MCP servers to integrate your local system tools with your enterprise collaboration suite.
> Make me a slide deck showing the git history from the last 7 days, grouped by feature and team member.
> Make a full-screen web app for a wall display to show our most interacted-with GitHub issues.
> Convert all the images in this directory to png, and rename them to use dates from the exif data.
> Organise my PDF invoices by month of expenditure.
For details on the terms of service and privacy notice applicable to your use of AiFlow CLI, see the Terms of Service and Privacy Notice.
FAQs
Intelligent AI Assistant with Smart Model Routing - Created by DavidFon
The npm package aiflow-cli receives a total of 8 weekly downloads. As such, aiflow-cli popularity was classified as not popular.
We found that aiflow-cli demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago.Β It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Socket found 37 malicious PyPI wheels that abuse Python startup hooks to launch a Bun-powered credential stealer tied to Mini Shai-Hulud/Miasma.
Security News
RubyGems and Bundler 4.0.13 introduced an opt-in cooldown feature that delays newly published gems during dependency resolution.
Security News
pnpm 11.5 now recognizes npm staged publish approvals in release metadata, preventing those releases from being mistaken for lower-trust package publishes.