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 liaThis 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.