ProxyFi is a modern, multi-provider CLI coding agent that brings the power of AI directly to your terminal. Built for developers who live in the command line, ProxyFi understands your codebase and helps you write, edit, and debug code with natural language.

🚀 Built with ❤️ by ULN Labs

✨ Features

• 🔌 Multi-Provider Support — Switch between Antigravity, Groq, and OpenRouter with a single keystroke
• 🧠 Intelligent Context — Automatically understands your project structure and git status
• 🛠️ Powerful Tools — Read, write, edit files and execute shell commands
• 💬 Interactive Chat — Beautiful terminal UI with streaming responses
• 🔐 Secure Auth — OAuth for Antigravity, API keys for Groq & OpenRouter
• ⚡ Token Management — Set per-provider token limits to control costs
• 🛡️ Safety First — Confirmation prompts for dangerous operations
• 🎨 Thinking Models — Full support for Claude, Gemini, and Llama reasoning

📦 Installation

npm install -g proxyfi

Or with your preferred package manager:

# yarn
yarn global add proxyfi

# pnpm  
pnpm add -g proxyfi

Requirements: Node.js 18.0.0 or higher

🚀 Quick Start

# Navigate to your project
cd your-project

# Start ProxyFi
proxyfi

That's it! ProxyFi will detect your workspace and start an interactive session.

First Time Setup

1. Choose a provider — Type /p to select your AI provider
2. Add credentials — Type /a to add OAuth account or API key
3. Start coding — Ask anything about your codebase!

🔌 Providers

ProxyFi supports multiple AI providers. Switch anytime with /p:

| Provider | Auth Type | Models | Best For | |----------|-----------|--------|----------| | 🔷 Antigravity | Google OAuth | Claude, Gemini | Unlimited usage, thinking models | | ⚡ Groq | API Key | Llama, Mixtral | Ultra-fast inference | | 🌐 OpenRouter | API Key | 100+ models | Model variety, pay-per-use |

Getting API Keys

• Antigravity — Uses Google OAuth (no key needed)
• Groq — Get your key at console.groq.com/keys
• OpenRouter — Get your key at openrouter.ai/keys

⌨️ Commands

Use these slash commands during chat:

| Command | Shortcut | Description | |---------|----------|-------------| | /provider | /p | Switch AI provider | | /model | /m | Change model | | /accounts | /a | Manage credentials & token limits | | /tools | /t | Toggle tool usage | | /thinking | /think | Toggle thinking display | | /status | /s | Show current configuration | | /clear | /c | Clear chat history | | /help | /? | Show help | | /quit | /q | Exit |

🛠️ Available Tools

When tools are enabled, ProxyFi can:

| Tool | Description | |------|-------------| | file_read | Read file contents with optional line ranges | | file_write | Create or overwrite files | | file_edit | Make targeted edits to existing files | | shell | Execute shell commands | | search | Search for patterns in code | | find_files | Find files by name pattern |

🛡️ Safety Features

ProxyFi includes built-in safety measures:

• 🔒 Workspace Boundaries — Operations are scoped to your project
• ⚠️ Dangerous Command Detection — Prompts for rm -rf, sudo, force push, etc.
• 🏠 Home Directory Protection — Never uses ~ as workspace root
• 💾 Token Limits — Set per-provider limits to control costs

📁 Configuration

Configuration is stored in ~/.config/proxyfi/:

~/.config/proxyfi/
├── config.json           # General settings
├── accounts.json         # OAuth accounts
├── api-keys.json         # API keys
└── provider-settings.json # Token limits

CLI Options

proxyfi [options]

Options:
  -m, --model <model>     Model to use
  -c, --context <path>    Working directory (default: current)
  --no-tools              Disable tools
  -V, --version           Show version
  -h, --help              Show help

🎯 Examples

# Start in current directory
proxyfi

# Start with specific model
proxyfi -m claude-sonnet-4-5-thinking

# Start in different directory
proxyfi -c /path/to/project

# Auth commands
proxyfi auth login
proxyfi auth status
proxyfi auth logout

Example Prompts

> Explain what this project does

> Find all TODO comments in the codebase

> Add error handling to the login function in auth.ts

> Run the tests and fix any failures

> Create a new React component for user profiles

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

# Clone the repo
git clone https://github.com/ulnlabs/proxyfi.git
cd proxyfi/cli-agent

# Install dependencies
npm install

# Build
npm run build

# Link for local development
npm link

📄 License

MIT © ULN Labs