Skip to content

lerim init

Interactive setup wizard for first-time Lerim configuration.

Overview

Run this once after installing Lerim. It detects your installed coding agents, lets you select which to connect, and writes the initial config to ~/.lerim/config.toml.

Host-only command

This command runs on the host machine. It does not require a running Lerim server.

Syntax

lerim init

What it does

  1. Scans for installed coding agents (Claude Code, Codex CLI, Cursor, OpenCode)
  2. Prompts you to select which agents to connect
  3. Writes the initial config to ~/.lerim/config.toml
  4. Checks for Docker availability
  5. Prints next steps

Example

lerim init

Output:

Welcome to Lerim.

Which coding agents do you use?
  claude (detected) [Y/n]: y
  cursor (detected) [Y/n]: y
  codex (not found) [y/N]: n
  opencode (not found) [y/N]: n

Config written to ~/.lerim/config.toml
Agents: claude, cursor

Docker: found

Next steps:
  lerim project add /path/to/repo   # register a project
  lerim up                           # start the Docker service

Notes

  • Running lerim init again overwrites the existing config
  • API keys are not stored in config — they come from environment variables
  • You can manually edit ~/.lerim/config.toml after init