Basic Usage

This guide introduces common use cases for Carry Code to help you get started quickly.

---

Scenario 1: Let AI Write Code

When you need to complete a programming task, just tell AI what you want.

Example

Write a script to batch rename files, replacing spaces with underscores

AI will:

1. Analyze your requirements
2. Write complete code
3. Explain how the code works
4. Ask if you want to execute

More Examples

Requirement	Conversation
Write an API	Write a simple REST API with Express.js, including user registration and login
Write a scraper	Write a Python script to crawl images from a webpage and save them locally
Write a utility script	Write a Shell script to batch compress all PDF files in the current directory

---

Scenario 2: Let AI Find Bugs

When you encounter errors, send the code and error message to AI.

Example

This code has an error, help me find the problem:

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

print(calculate(10, 0))

AI will:

1. Analyze the error (division by zero)
2. Provide a fix
3. Explain the changes

Better Ways to Ask

My code has an error. The error message is:
[paste error message]

The code is:
[paste code]

Please help me find and fix the problem.

---

Scenario 3: Let AI Explain Code

Don’t understand some code? Just send it to AI for explanation.

Example

Explain what this code does:

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

AI will:

1. Explain the code logic line by line
2. Provide execution flow diagrams if helpful
3. Offer simplified versions if available

More Scenarios

Scenario	Conversation
Understand open source	Help me analyze the main structure of this project
Learn new syntax	What’s the difference between TypeScript’s type and interface?
Understand algorithms	Explain how this sorting algorithm works

---

Scenario 4: Let AI Refactor Code

Code works but is messy? Let AI help you optimize.

Example

This code works but feels messy, can you help me optimize it?

[paste your code]

AI will:

1. Analyze code issues
2. Provide an optimized version
3. Explain what improvements were made

Common Refactoring Needs

Requirement	Conversation
Improve performance	This code is too slow, help me optimize
Improve readability	This code is hard to understand, please refactor for clarity
Add error handling	Help me add error handling to this function

---

Scenario 5: Let AI Write Tests

Don’t want to write tests manually? Let AI help.

Example

Write unit tests for this function:

function sum(a, b) {
  return a + b;
}

AI will generate complete test cases including normal and edge cases.

Better Ways to Ask

Write Jest tests for this function, covering:
1. Normal addition
2. Negative numbers
3. Decimal numbers

[paste function code]

---

Scenario 6: Let AI Write Documentation

Need documentation for your project? Let AI generate it.

Example

Write a README.md for this project

AI will analyze the project structure and generate a README with:

• Project description
• Installation instructions
• Usage instructions
• API documentation (if applicable)

Partial Documentation

Add JSDoc comments to this function:

function calculate(a, b) {
  return a + b;
}

---

Scenario 7: Let AI Analyze Projects

Want to understand an unfamiliar project? Let AI analyze it.

Example

Analyze the structure of this project

AI will:

1. List the project directory structure
2. Explain main files and their purposes
3. Describe the tech stack

More Specific Analysis

Requirement	Conversation
Analyze dependencies	What dependencies does this project use?
Find code	Where is the user login code?
Analyze architecture	How is this project organized?

---

Scenario 8: Execute Shell Commands

Carry Code can help you execute terminal commands.

Example

Run `npm install` to install dependencies

Or:

List files in the current directory

Notes

• AI will ask for confirmation before executing
• Dangerous commands (like deleting files) require extra confirmation
• You can adjust permission levels using the /approval command

---

Common Keyboard Shortcuts

Shortcut	Action
Enter	Send message
Shift + Enter	New line (multi-line input)
Shift + Tab	Switch Build/Plan mode
↑ / ↓	Browse message history
Ctrl + C	Interrupt AI response
Ctrl + D	Exit the program

---

Next Steps

• Dual Mode - Learn more about Build and Plan modes
• Session Management - Manage your conversation sessions
• AI Model Configuration - Add more AI models