Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@0vv/yolo-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

YOLO CLI

Interactive AI command-line interface powered by OpenRouter

YOLO CLI is a terminal-based application that enables seamless interaction with multiple AI models through OpenRouter's unified API. Built with TypeScript and Ink framework, it provides a keyboard-driven interface where you can cycle through different AI models and maintain conversation context across sessions.

Features

🤖 Multiple AI Models: Access to Kimi K2, MiniMax M2, GLM-4.6, and more through OpenRouter
⌨️ Model Switching: Cycle through models with Shift+Tab
💬 Interactive Chat: Real-time streaming responses
📝 Multi-line Input: Support for complex queries
💾 Multi-Session Support: Multiple independent conversations per directory with UUID-based session files
⚡ Slash Commands: Quick actions with /clear, /new, /compact, /version, /help, /exit
🔍 Smart Autocomplete: Intelligent completion for commands (/) and file paths (@)
🗜️ Conversation Compaction: AI-powered summarization to reduce token usage (20+ message threshold)
🔧 MCP Support: Automatic Model Context Protocol server loading for extended tool capabilities
🚀 Fast Setup: 2-minute first-run configuration
🎨 Terminal UI: Clean, keyboard-driven interface

Prerequisites

Node.js 18.0.0 or higher
OpenRouter API key (Get one here)

Installation

npm install -g @0vv/yolo-cli

Or use npx without installation:

npx @0vv/yolo-cli

Quick Start

Launch YOLO CLI:
```
yolo
```
Or if using npx:
```
npx @0vv/yolo-cli
```
Enter your OpenRouter API key when prompted
Select models to enable
Start chatting!

Usage

Interactive Mode

yolo

Type your query and press Enter. The AI response streams in real-time.

Cycle Through Models

Press Shift+Tab to cycle through your enabled models. The current model appears in the status bar.

One-Off Query

yolo -q "What is TypeScript?"

Specify Model

yolo -m anthropic/claude-3-opus -q "Explain quantum computing"

Continue Previous Session

yolo --continue

Keyboard Shortcuts

Key	Action
Enter	Send message
Shift+Enter	Insert newline
←/→	Move cursor left/right
Cmd/Ctrl+←	Move to start of line
Cmd/Ctrl+→	Move to end of line
Ctrl+A	Move to start of line (Unix-style)
Ctrl+E	Move to end of line (Unix-style)
Backspace	Delete character before cursor

Application Controls

Key	Action
Ctrl+C	Interrupt streaming request
Ctrl+D	Exit YOLO CLI
Shift+Tab	Cycle through AI models

Autocomplete

Key	Action
Tab	Complete command or file path (when typing `/` or `@`)
↑/↓	Navigate autocomplete suggestions
Esc	Cancel autocomplete
Enter	Accept suggestion and execute

Slash Commands

YOLO CLI supports slash commands with intelligent autocomplete. Type / to see available commands:

Command	Alias	Description
`/model`	`/models`	Select or change AI model
`/clear`	`/reset`	Clear conversation history (with confirmation)
`/new`	-	Start a new session in current directory
`/compact`	-	Summarize long conversations to reduce context
`/version`	-	Show YOLO CLI version
`/help`	`/h`, `/?`	Show available commands
`/exit`	`/quit`	Exit YOLO CLI

Command Autocomplete: Type / to trigger intelligent autocomplete. Use arrow keys to navigate, Tab or Enter to complete, and Esc to cancel. Autocomplete filters commands as you type (e.g., /cl shows /clear).

File Path Mentions: Type @ to trigger file path autocomplete. Start typing a file name or path to see matching files from your current directory. Use arrow keys to navigate, Tab to complete, and Esc to cancel. For short queries (< 3 characters), only top-level files are shown. For longer queries or paths containing /, all matching files are displayed.

Multi-Session Support: The /new command creates additional session files in .yolo/history-{uuid}.jsonl format, allowing you to maintain multiple independent conversations in the same directory.

Conversation Compaction: When conversations exceed 20 messages, use /compact to summarize older messages while preserving recent context. This reduces token usage and keeps conversations within context limits.

Configuration

Configuration is stored at:

Linux/macOS: ~/.config/yolo-cli/config.json
Windows: ~/.yolo-cli/config.json

Conversation history is saved in .yolo/history.jsonl in each working directory.

MCP Server Configuration

YOLO CLI supports automatic loading of Model Context Protocol (MCP) servers for extended tool capabilities. Configure MCP servers once and they'll load automatically on startup.

Global MCP Configuration (applies to all projects):

Linux/macOS: ~/.config/yolo-cli/mcp.json
Windows: ~/.yolo-cli/mcp.json

Project-specific MCP Configuration:

.yolo/mcp.json in your project directory

Example mcp.json:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your_token_here"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
    }
  }
}

For detailed MCP configuration guide, see MCP Quickstart.

Development

# Clone repository
git clone https://github.com/your-org/yolo-cli.git
cd yolo-cli

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Development mode
npm run dev

Documentation

Quickstart Guide: YOLO CLI Quickstart
Slash Commands: Slash Commands Guide
MCP Configuration: MCP Quickstart
Changelog: CHANGELOG.md

License

MIT

Support

Documentation: Full Docs
Issues: GitHub Issues
OpenRouter: OpenRouter Docs

@0vv/yolo-cli