Quick Start

Alpha Testing

Lody is currently in Alpha testing. All user data from the Alpha testing period will be cleared after the Alpha phase ends.

Prerequisites

• Node.js 18 or later
• Git installed and configured
• Install the GitHub CLI
  • macOS: brew install gh
  • Linux: Installation instructions

Network Requirements

The CLI needs access to the following services:

• Your Coding Agent (Claude Code / Codex)
• GitHub (for cloning repositories)
• npm registry

Start

npx lody start

This starts the Lody CLI. It automatically detects Claude Code and Codex installed on your current machine, then creates a default Agent Config so you can pick the corresponding CLI type in the chat UI. The CLI keeps running and continuously handles chat requests from the web app.

Connect Your GitHub Repository

In the web app, click Settings -> Integrations -> Manage to authorize GitHub access. After the redirect back to Lody, add the repositories you need to your workspace. Learn more

File Locations

Content	Path
Repositories	~/.lody/repos
Log files	~/.lody/logs

Next Steps

• Learn about WorkTrees - Understand how Lody isolates tasks
• Configure Agents - Set up Claude Code, Codex, or Claude-compatible endpoints
• Mobile Access - Review and approve changes from your phone