Developer entry and source map
For application changes, extensions and documentation maintenance. To use the app for your own projects, start with the manual.
Open
Project and architecture
Understand structure
Build, then read architecture and modules/dependencies. These distinguish Gradle modules, source sets, UI, orchestration, Handlers, data and platform capabilities.
Trace state
Lifecycle covers sends, tool rounds, cancellation, continuation and resource ownership. Callbacks/scopes documents signatures, timing and editor ownership examples. Persistence covers branch transactions, archive, migrations and backup boundaries.
Choose an implementation guide
| Change | Guide |
|---|---|
| Tools, arguments, results or approvals | Tool contracts |
| Providers, history or stream parsing | Provider/stream adaptation |
| URIs, edits or Linux processes | Workspace/runtime APIs |
| External or phone MCP | MCP protocol/APIs |
| Browser actions, snapshots or uploads | Web bridge/state sync |
| Skill discovery/package loading | Extensions |
| Pet JS, events or disposal | Pet lifecycle |
| Validation | Testing/debugging |
| Pages, navigation, translation, deployment | Documentation maintenance |
Repositories and command locations
Application source contains Android, runtimes and tests. Documentation source contains VitePress, navigation and examples. A local vite_docs/ checkout retains separate Git history. Run Gradle in the application root and npm in the documentation repository.
Short Kotlin paths usually refer to app/src/main/java/com/yukisoffd/lyracode/; PRoot lives in app/src/debianRuntime/. Package declarations may differ from physical directories.
Examples and delivery
API pages identify teaching fragments, host-supplied variables and runnable examples. Complete downloads are in examples. Report trigger, behavior, actual validation and remaining limits. UI, permissions and runtimes require suitable device checks.
The application README accepts organization-member PRs; contact administrators to join. Original code uses AGPLv3 and third-party components retain their licenses. Read LICENSE and THIRD_PARTY_NOTICES.md before redistribution.