Code Agents

Quickstart with Lia

Get Lia up and running in your local environment or IDE with step-by-step setup guides.

By the end of this guide, you'll have Lia configured and ready to work in your preferred development environment.

Configuring Lia with the CLI

The easiest way to set up Lia is through the ExzosSphere CLI. Even after initial project creation, you can configure or update Lia at any time.

Run the Lia configuration command

npx exzossphere@latest lia

This launches an interactive menu for managing Lia configurations.

Choose your action

The main menu offers several options:

  • Initialize LIA on my Code Agents: Set up Lia for your preferred development tools
  • Sync All Configurations: Update all AI code agent settings across your environment
  • Update .gitignore: Add Lia-specific patterns to your .gitignore file
  • Exit: Close the menu

Configure code agents (if selected)

When initializing Lia, you'll see a multi-select list of supported code agents:

  • GitHub Copilot
  • Cursor
  • Claude Code
  • Codex CLI
  • Gemini CLI
  • OpenCode
  • Cline
  • Roo Code
  • Qwen Code
  • Kiro IDE
  • Amazon Q Developer CLI
  • JetBrains Junie
  • AugmentCode
  • Windsurf
  • Warp

Select all the agents you use, then confirm to apply the configuration. This replaces their default training with Lia's specialized setup for the ExzosSphere ecosystem.

Verify the setup

After configuration, Lia will be ready to work in your chosen agents. Test her by asking for help with a simple task, like creating a new page or controller.

Local Environment Setup

Using Codex CLI

Ensure proper permissions

Make sure your environment has the correct permissions for filesystem and network access.

Configure approval policy

Set up approval policies if needed for your specific use case.

IDE Integration

Cursor/VS Code

Point the agent at your repository

Configure your IDE to point Lia at your project repository and the .mcp.json file.

Set up context

Ensure Lia has access to the full project context for optimal performance.

Claude Code

Configure MCP endpoints

Set up the Model Context Protocol endpoints in your Claude Code configuration.

Establish context

Provide the necessary context files and project information for Lia to work effectively.

Troubleshooting