3 WAYS TO INSTALL

Pick the method that best fits your workflow.

🐍

Python / PyPI

RECOMMENDED

Works across Windows, macOS, and Linux with Python 3.8+.

pip install cutoken
📦

Node.js / NPM

Install globally via npm for JavaScript & Node environments.

npm install -g cutoken

HOW TO USE

Everything you need to master CuToken in your terminal.

01

Login & Link Your Account

Run cutoken login once. Paste your Pro API key from your dashboard. It stays securely stored in ~/.cutoken/config.json.

02

Quick Single-Prompt Optimization

Pass your prompt directly or optimize a file on disk:
cutoken "Act as senior developer and rewrite this..."
cutoken -f system_prompt.txt

03

Smart Multi-Paragraph Paste

Launch interactive REPL with cutoken. Paste huge multi-paragraph prompts or system instructions seamlessly without premature triggers.

04

Configure Modes & Models

Switch between safe, balanced, or aggressive:
cutoken mode aggressive
cutoken --model gpt-4o "Analyze this..."

05

Automatic Clipboard Sync

Every optimized result is automatically copied to your clipboard so you can directly press Ctrl+V / Cmd+V into Claude, ChatGPT, or Cursor.

$ cutoken
   ______     ______     __              
  / ____/_  _/_  ____/___  / /_____  ____   
 / /   / / / // / / __ \/ //_/ _ \/ __ \  
/ /___/ /_/ // / / /_/ / ,< /  __/ / / /  
\____/\__,_//_/  \____/_/|_|\___/_/ /_/   

Logged in: Pro Account (1,250 cr)
Mode: balanced (default) | Model: gpt-4o

cutoken > "You are an expert full stack software engineer..."
✔ Optimized in 280ms
─────────────────────────────────────────────────────────────
 Original: 84 tok   Optimized: 42 tok   Saved: -42 (50.0%)
─────────────────────────────────────────────────────────────
📋 Copied to clipboard! Ready to paste into ChatGPT/Claude.

COMMAND REFERENCE

Command Description Example
cutoken Starts interactive REPL session cutoken
cutoken "prompt" Optimizes prompt passed as argument cutoken "summarize this data"
cutoken -f <file> Optimizes prompt from text file cutoken -f prompt.txt
cat <file> | cutoken Unix stdin piping for shell scripts git diff | cutoken
cutoken login Stores your Pro API Key cutoken login
cutoken balance Checks live credit balance cutoken balance
cutoken mode <name> Sets default mode (safe | balanced | aggressive) cutoken mode aggressive

READY TO SAVE TOKENS IN YOUR TERMINAL?

Get your API key from the Pro dashboard and start saving tokens with every keystroke.