<p align="center">
<a href="https://play.google.com/store/apps/details?id=ai.lody.android">
<img src="https://img.shields.io/badge/Google_Play-414141?logo=google-play&logoColor=white"/>
</a>
<a href="https://apps.apple.com/us/app/lody-run-code-agent-anywhere/id6761373528">
<img src="https://img.shields.io/badge/App_Store-0D96F6?logo=app-store&logoColor=white"/>
</a>
<a href="https://lody.ai/download">
<img src="https://img.shields.io/badge/macOS-000000?logo=apple&logoColor=F0F0F0"/>
</a>
<a href="https://lody.ai/download">
<img src="https://custom-icon-badges.demolab.com/badge/Windows-0078D6?logo=windows11&logoColor=white"/>
</a>
<a href="https://lody.ai/download">
<img src="https://img.shields.io/badge/Linux-FCC624?logo=linux&logoColor=black"/>
</a>
</p>
<p align="center">
<a href="https://lody.ai">
<picture>
<img src="./site-docs/public/icon-mac.png" width="128"/>
</picture>
</a>
</p>
<h1 align="center">
<a href="https://lody.ai" alt="lody-site">Lody</a>
</h1>
<p align="center">
<b>English</b> | <a href="./README.zh-CN.md">简体中文</a>
</p>
<p align="center">
<b>A shared workspace for the coding agents your team already uses.</b>
</p>
<p align="center">
Connect any machine and bring any coding agent through ACP. Share conversations with your team and dispatch work from desktop, mobile, web, or CLI.
</p>
<p align="center">
<a href="https://lody.ai/docs/">
<b>Documentation</b>
</a>
|
<a href="https://lody.ai/docs/quickstart">
<b>Getting Started</b>
</a>
</p>
<p align="center">
<a aria-label="X" href="https://x.com/intent/follow?screen_name=lody_ai" target="_blank">
<img alt="" src="https://img.shields.io/badge/X-%23000000.svg?style=for-the-badge&logo=X&logoColor=white">
</a>
<a aria-label="Discord-Link" href="https://discord.gg/E8mZtMu38s" target="_blank">
<img alt="" src="https://img.shields.io/badge/Discord-black?style=for-the-badge&logo=discord">
</a>
</p>
<p align="center">
<img src="./site-docs/public/_docs-assets/lody-readme-hero.png" alt="Lody running coding Agents across desktop and mobile" width="100%" />
</p>
## What you can do with Lody
### Share Agent conversations with your team
Open the same conversation with your teammates. See the full transcript, runtime status, files, and code changes around the work, then add instructions without passing around screenshots or pasted logs.
### Bring the Agents and machines you already use
Connect Claude Code, Codex, Kimi, OpenCode, or another ACP-compatible Agent. Keep using the subscriptions, logins, models, and permission modes configured on your laptops, workstations, servers, and cloud VMs. Machines remain private until their owner shares them with the workspace.
### Dispatch work from any surface
Choose any connected machine when dispatching work from desktop, mobile, web, or CLI. Permission requests, progress, conversations, and code changes stay visible across these surfaces.
## Connect a machine
Run Lody on a workstation, server, or cloud VM:
```bash
npx lody daemon start
```
The command opens a sign-in link, connects the machine to your workspace, and keeps it available for work dispatched from desktop, mobile, web, or CLI.
## Use Lody from the CLI
The CLI is more than the process that connects a machine. From a terminal or script, you can register local projects; inspect workspaces, machines, linked repositories, and Agent configs; create and message sessions; read their history and status; or archive and restore them. Commands that support `--json` can also feed Lody workspace data into your own tools.
```bash
npx lody session create --workspace my-team --agent-config codex \
--repo owner/repo "Fix the failing test"
npx lody session list --workspace my-team
```
See the [CLI documentation](https://lody.ai/docs/cli) for the full command reference.
## Let Agents coordinate work across conversations
Lody gives Agents tools to create or reuse other conversations, read their status and history, send follow-up instructions, cancel running work, and bring results back. This lets one conversation act as the coordinator: you can analyze a bug with a main Agent, then have it delegate investigation, implementation, and testing to separate conversations running in parallel.
Lody keeps each child conversation independent while preserving its relationship to the conversation that created it. Conversations can also be referenced with an `@` mention when you or an Agent needs to connect work across sessions.
## Keep code and execution in the same workspace
### Keep parallel work isolated
Give sessions their own Git worktrees so Agents can work in parallel without mixing changes. Open multiple chats, files, diffs, terminals, and previews in tabs, or fork a session into another conversation or worktree to explore a different approach.
### Inspect changes where the work happened
Browse project files and inspect per-turn or full-session diffs beside the conversation. Add line-level comments, follow pull request status and CI, and keep GitHub review threads close to the Agent that produced the change.
<p align="center">
<img src="./site-docs/public/_docs-assets/PR-panel.png" alt="A pull request and its CI status beside an Agent conversation" width="100%" />
</p>
### Give Agents visual feedback
Open a running web app inside the session, switch between responsive viewports, and send element-level visual annotations back to the Agent.
<p align="center">
<img src="./site-docs/public/_docs-assets/20260507-preview.png" alt="Annotating a running web app and sending the feedback to an Agent" width="100%" />
</p>
## More built in
- **Agent Roles** — share reusable Agent, model, permission, and instruction presets with the team.
- **Attachments** — send files and images from desktop, mobile, web, or CLI, and receive files produced by Agents.
- **Session tools** — search, pin, archive, fork, and organize conversations without losing their history.
- **Desktop tools** — use a built-in terminal, command palette, customizable shortcuts, and open files in your editor.
- **Mobile controls** — receive notifications, approve permission requests, inspect diffs, and follow active work with iOS Live Activities.
- **Usage visibility** — see context, token and quota usage, plus machine and Agent resource consumption.
<p align="center">
<img src="./site-docs/public/_docs-assets/20260611-island.png" alt="Approving an Agent permission request from an iPhone Live Activity" width="60%" />
</p>
## Beyond conversations
Shared conversations are Lody's starting point, not the whole workspace.
We plan to add documents and document sandboxes so teams can shape requirements, preserve decisions, and work with Agents outside the timeline of a single conversation. Over time, these tools can become shared team context for understanding not only what changed, but why.
We want the entire workspace—not only conversations—to become local-first. Lody uses the [Loro](https://loro.dev/) Stack, including Loro and Flock, to represent and synchronize collaborative state with CRDTs. The same foundation can extend from conversations to documents and future workspace tools. Our goal is for team context to become more durable and portable, and ultimately remain under the team's control.
Lody is still moving toward full local-first support.
## Releases
Pushing a stable `vX.Y.Z` tag creates a draft PR synchronizing every
`apps/*/package.json` version on the default branch, followed by a GitHub Release
with generated changelog notes. No installers or auto-update files are built or
uploaded. The original tag is not moved; version synchronization takes effect
on the default branch after the PR is merged. GitHub Actions must be allowed to
create pull requests in repository settings. Bot-created PRs may require a maintainer
action to trigger CI. Existing releases and their assets are preserved on reruns.
## Repository
- `apps/cli` — Connect machines and run coding agents
- `apps/electron` — Lody desktop app
- `packages/components` — Shared workspace UI
- `packages/ui` — Base UI primitives and StyleX design tokens
- `packages/platform` — Platform capabilities and integrations
- `packages/shared` — Shared schemas, protocols, and utilities
- `packages/cloud-api` — Optional-cloud protocol names and DTOs
- `packages/e2ee-core` — End-to-end encryption library: signed ledger, key delivery, services and adapters ([reading guide](packages/e2ee-core/README.md), not yet wired into the product)
- `packages/e2ee-lab` — Local adversarial consumers and persistence probes for `@lody/e2ee-core`
- `packages/loro-streams-rpc` — RPC over Loro Streams
- `packages/acp-extension-{core,kimi}` — ACP extension submodule workspaces
- `site-docs` — Website, documentation, and blog
See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and the community PR size policy.