ShuttleAI CLI

🚀 ShuttleAI CLI — Autonomous coding agent powered by ShuttleAI

Meet Shuttle, an AI assistant that lives in your terminal. Shuttle can handle complex software development tasks step-by-step — creating and editing files, exploring large projects, running terminal commands, and more.

npm i -g shuttle-ai

# cd into your project and run:
shuttle

---

🔑 Getting an API Key

1. Visit shuttleai.com/keys
2. Create a free account and generate an API key (starts with shuttle-)
3. Run shuttle — you'll be prompted to enter your key on first launch

Or set the environment variable for headless/CI use:

export SHUTTLEAI_API_KEY=shuttle-your-key-here
shuttle "explain this codebase"

---

📦 Installation

git clone https://github.com/ethancroissants/shuttle-cli
cd shuttle-cli
bash install.sh

That's it. The script installs dependencies, builds the CLI (~4 seconds), and links shuttle globally.

On first run, you'll be prompted for your ShuttleAI API key — no env vars needed. Get one free at shuttleai.com/keys.

---

🚀 Usage

# Interactive mode (shows welcome prompt)
shuttle

# Start a task directly
shuttle "refactor this module to use async/await"

# Plan mode
shuttle --plan "design a REST API for a todo app"

# Auto-approve all actions (yolo mode)
shuttle --yolo "add unit tests for all functions"

---

🤖 Models

ShuttleAI provides access to models from OpenAI, Anthropic, and open-source providers through a single unified API:

Model	Provider	Tier
shuttleai/auto	ShuttleAI	Basic — smart router, picks best model
gpt-5.2	OpenAI	Basic
gpt-oss-120b	OpenAI	Free
claude-opus-4.6	Anthropic	Premium
claude-sonnet-4.6	Anthropic	Premium
claude-haiku-4.5	Anthropic	Basic

Change model with the --model flag or /model slash command in interactive mode.

---

⚙️ Configuration

Config and session data is stored in ~/.shuttle/data/.

Override with: export SHUTTLEAI_DATA_DIR=/path/to/data

---

📄 License & Credits

ShuttleAI CLI is a fork of Cline by Cline Bot Inc., licensed under the Apache 2.0 License.

Changes from upstream Cline:

• Replaced multi-provider auth flow with ShuttleAI API key onboarding
• Hardcoded ShuttleAI (https://api.shuttleai.com/v1) as the backend — OpenAI-compatible
• Rebranded CLI binary from cline → shuttle
• Config directory changed from ~/.cline → ~/.shuttle