Introduction
Get started with TurboDev.
TurboDev is a terminal-based AI coding agent. Chat with LLM models (via OpenRouter), execute tools, manage files and code — all without leaving the CLI.
Features
- Terminal AI Chat — Real-time streaming conversations with LLM models
- Multi-Agent System — Switch between specialized agents (editor, plan) with a single keypress
- Custom Agents — Define your own agents via Markdown files
- Permission System — Fine-grained control over what agents can do
- Tool Integration — Read, edit, create files, run bash commands, search code
- Context-Aware — Automatic project analysis via
AGENTS.md - Session Persistence — Conversations are saved and can be resumed across restarts
- Context Window Management — Live token tracking, auto-compaction, and manual
/compact - Real-time Cost Tracking — See how much you're spending in the status bar
- Request Interruption — Press Escape to cancel a running AI request
- Agent Skills — Extend agent capabilities with installable skill packs (
.agents/skills/) - MCP Support — Connect external tool servers via the Model Context Protocol (
.turbodev/mcp.json) - Persistent Memory — The AI remembers your preferences, decisions, and project facts across sessions (
.turbodev/memory.md) - Economy Mode — Cut token usage ~50-70% with concise output (
/economy eco|ultra)
Prerequisites
- Node.js 18 or later
- An OpenRouter API key (get one here)
Quick Start
TIP
Run npx @rosariomoscato/turbodev in any project directory to get started immediately.
bash
# Install globally
npm install -g @rosariomoscato/turbodev
# Navigate to your project
cd /path/to/your/project
# Launch TurboDev
turbodevOn first launch, the setup wizard will ask for your OpenRouter API key and preferred model.