🚀 Installation

ce-tool is a Python package. Ensure you have Python 3.11+ installed. Once installed, the ce command will be available globally in your terminal.

Option 1: Install via pip (Recommended for all platforms)

Windows, macOS, and Linux:

pip install ce-tool

Option 2: Install from Source (Git Clone)

If you prefer to clone the repository and run it locally, follow these steps.

Windows, macOS, and Linux:

# 1. Clone the repository
git clone https://github.com/thedotmack/claude-efficient.git

# 2. Navigate into the directory
cd claude-efficient

# 3. Install the package globally so the 'ce' command works anywhere
pip install -e .

✨ Quick Start

1. Initialize your project:

   ce init
   

   This command sets up your project with a CLAUDE.md, .claudeignore, and other necessary configurations for optimal performance.

2. Run a task:

   ce run "Your task description here. For example, build a FastAPI endpoint for user auth."
   

   This is the main command you'll use. It automatically optimizes your request, manages session context, and routes it appropriately.

3. Check your savings:

   ce gains
   

   This command displays a detailed dashboard of your token savings across different operations. Token savings are tracked automatically and stored globally (~/.ce-telemetry.jsonl), allowing you to view your total savings across all projects.

🤖 Other AI CLIs

While ce acts as an optimizing wrapper around Claude Code, ce-tool also provides drop-in token optimization wrappers for other popular AI command-line tools. These wrappers apply the same prompt optimizations and track your token savings in the global ce gains dashboard.

• ce-gemini: Wraps the Google Gemini CLI (gemini).
• ce-codex: Wraps the OpenAI Codex CLI (codex).
• ce-cursor: Wraps the Cursor CLI (cursor).
• ce-opencode: Wraps the OpenCode CLI (opencode).

You can use these just like their underlying commands (e.g. ce-gemini run "my task").

📋 Commands

claude-efficient provides a suite of commands to manage your workflow and optimize token usage.