AI Agent
The AI Agent in List Coder can handle entire coding tasks autonomously. Unlike Tab completion which works line-by-line, the Agent operates at the project level — understanding your codebase and making changes across multiple files.
Capabilities
Code Generation
Describe what you need in natural language and the Agent generates complete, working code.
"Add error handling for null values in the user object across all API endpoints"
The Agent will:
- Analyze your existing code patterns
- Generate appropriate error handling
- Apply changes across all relevant files
- Maintain consistency with your codebase
Bug Fixing
Point the Agent to a bug and it will analyze the code, identify the root cause, and implement a fix.
"The login form doesn't validate email addresses properly"
The Agent will:
- Locate the login form component
- Analyze the current validation logic
- Implement proper email validation
- Add error messages for invalid input
Refactoring
Restructure code for better performance, readability, or maintainability.
"Extract the database logic from this component into a separate service layer"
The Agent will:
- Identify all database-related code in the component
- Create a new service file
- Move the logic while maintaining functionality
- Update imports and dependencies
Test Generation
Automatically generate unit tests for your functions and classes.
"Write unit tests for the UserService class"
The Agent will:
- Analyze the UserService class
- Identify all public methods
- Generate comprehensive test cases
- Include edge cases and error scenarios
How to Use the Agent
Opening the Agent
- Press
Ctrl + L(orCmd + Lon macOS) - Or click the AI icon in the sidebar
Writing Effective Prompts
Be specific:
- ❌ "Fix this"
- ✅ "Add error handling for null values in the user object and show a toast notification when validation fails"
Provide context:
- ❌ "Make it faster"
- ✅ "Optimize the database query in src/api/users.ts to use pagination instead of loading all records"
Break down complex tasks:
- ❌ "Rewrite the entire app"
- ✅ "Refactor the authentication module to use JWT tokens instead of session cookies"
Agent Modes
Autonomous Mode
The Agent makes changes automatically and shows you the results. Best for well-defined tasks.
Interactive Mode
The Agent asks for confirmation before making each change. Best for complex or uncertain tasks.
Preview Mode
The Agent shows you what it plans to do before executing. Best for reviewing changes before they're applied.
Best Practices
Start Small:
Begin with simple tasks to understand how the Agent works. As you become more comfortable, tackle larger refactoring tasks.
Review Changes:
Always review the Agent's changes before accepting them. Use the visual checkpoint system to inspect each modification.
Provide Feedback:
If the Agent's output isn't what you expected, provide feedback in your next prompt. The Agent learns from your corrections.
Limitations
- The Agent works best with clear, specific instructions
- Very large codebases may require breaking tasks into smaller pieces
- The Agent cannot access external services or APIs without MCP configuration
- Complex architectural changes may require multiple iterations
Related Features
- Tab Completion — Line-by-line AI suggestions
- Composer — Multi-file editing with context
- MCP Integration — Connect external tools