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.

Sign In

Lody supports four identity providers on the sign-in page:

• GitHub
• Google
• Apple
• Discord

Pick whichever account you want to use. You can always link GitHub separately from Settings → GitHub even if you signed in with Google, Apple, or Discord.

For headless machines (CI runners, remote servers, containers) use a CLI token with lody login --auth <token> or lody start --auth <token>. See Non-Interactive Login with --auth.

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

# Recommended: run in the background
npx lody daemon start

# Temporary foreground mode for debugging
npx lody start

npx lody daemon start starts the Lody CLI in the background and brings it back if it exits unexpectedly. The CLI 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.

Use npx lody start when you want foreground logs in the current terminal or need to debug startup.

Connect Your GitHub Repository

In the web app, click Settings -> GitHub -> 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

• CLI Commands - See all lody commands and options
• 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