Skip to content
Carry Code | Docs

Quick Start

This guide will help you start using Carry Code for AI-powered programming conversations.

Start Interactive Mode

Section titled “Start Interactive Mode”

Run this command in your terminal to start Carry Code:

Terminal window
carry

This opens a beautiful terminal interface, waiting for your input.

Start a Conversation

Section titled “Start a Conversation”

After setup, you can start chatting with AI! Try typing:

Help me write a Python script to organize all image files in the current directory into a folder

Press Enter, and AI will start working. It will:

  1. Analyze your requirements
  2. Write code
  3. Ask if you want to execute

Two Usage Modes

Section titled “Two Usage Modes”

Interactive Mode (Default)

Section titled “Interactive Mode (Default)”
Terminal window
carry

Starts the full terminal UI for multi-turn conversations with automatic context preservation.

One-Shot Mode

Section titled “One-Shot Mode”
Terminal window
carry --once "Explain what this function does"
carry --once "Add error handling to server.js" --timeout-ms 60000

Executes a one-time prompt and exits. Great for scripts and CI scenarios.

Basic Operations

Section titled “Basic Operations”

Send Messages

Section titled “Send Messages”
  • Enter - Send message
  • Shift + Enter - New line (multi-line input)
Section titled “Navigate”
  • ↑ / ↓ - Browse message history
  • ← / → - Move cursor in current input

Interrupt & Exit

Section titled “Interrupt & Exit”
  • Ctrl + C - Interrupt AI’s current response
  • Ctrl + D - Exit the program

Slash Commands

Section titled “Slash Commands”

Type / in the input area to open the command menu for quick access to various features:

CommandDescription
/modelSwitch or add AI models
/mcpManage MCP servers
/skillLoad skills
/themeSwitch themes
/languageSwitch language
/sessionSession management
/exitExit the program

💡 Tip: Type / then press up/down arrows to quickly browse all available commands.

Mode Switching: Build vs Plan

Section titled “Mode Switching: Build vs Plan”

Carry Code has two working modes:

🔨 Build Mode (Default)

Section titled “🔨 Build Mode (Default)”

AI can read/write files and execute commands. Great for having AI write code for you.

📋 Plan Mode

Section titled “📋 Plan Mode”

AI can only read and cannot modify anything. Great for having AI analyze problems and plan solutions.

Press Shift + Tab to switch between the two modes.

First Conversation Examples

Section titled “First Conversation Examples”

Example 1: Write Code

Section titled “Example 1: Write Code”
Write a script to batch rename files, replacing spaces with underscores

AI will write complete code based on your requirements and explain each part.

Example 2: Find Bugs

Section titled “Example 2: Find Bugs”
This code has an error, help me find the problem:


def calculate(a, b):
    return a / b


print(calculate(10, 0))

AI will analyze the problem and tell you how to fix it.

Example 3: Explain Code

Section titled “Example 3: Explain Code”
Explain what this code does:


const result = arr.filter(x => x > 0).map(x => x * 2).reduce((a, b) => a + b, 0);

AI will explain line by line, and can even draw diagrams to help you understand.

Next Steps

Section titled “Next Steps”