English | [简体中文](README.zh-CN.md)

**Development status:** LiliaCode is evolving quickly. Keep independent copies of important work because local schemas and migration paths may change.

LiliaCode

A native Agent collaboration desktop client for software engineering.

LiliaCode uses the Lilia product protocol implemented by Mutsuki AgentKit. Its NanaUI/WGPU desktop organizes projects, task-shaped sessions, permissions, pending interactions, and recoverable execution timelines without a web desktop runtime.

Repository

• apps/desktop: the only desktop application, built with Rust, NanaUI, and WGPU
• apps/service: the shared service entry
• apps/android: the experimental Android remote companion; Gradle remains the platform build system
• crates/lilia-contracts/contracts: canonical product contracts consumed by Rust
• xtask: repository verification, debug, performance, Android, and release orchestration
• docs: Markdown design and product documentation; no documentation site is built or published

The `liliacode` command-line arguments are handled by `apps/desktop` only for application launch, project opening, explicit import, task handoff, and single-instance forwarding. LiliaCode does not provide a TUI, an Agent CLI, or a second command-line Agent host.

Development

Install the stable Rust toolchain, then run commands from the repository root:

cargo run
cargo xtask verify
cargo xtask agent-debug
cargo xtask performance

Agent Debug evidence is written under `agent-debug-runs/lilia-*`. Android commands are `cargo xtask android doctor|test|build|smoke`.

Windows release

Windows releases use NSIS and Minisign-compatible updater signatures:

cargo xtask release windows --tag vX.Y.Z
cargo xtask installer-smoke --tag vX.Y.Z

The `v*` GitHub workflow bui