eliza app development
This repository is an elizaOS application: a local-first assistant with CLI, dashboard, Electrobun desktop shell, connectors, and Eliza Cloud integration. Eliza is this app’s product and CLI name—not a separate platform from elizaOS.
Read These References First
references/repo-map.md for layout, edit targets, and common commands
references/runtime-and-cloud.md for runtime flow, onboarding, service routing, skills, and Eliza Cloud behavior
Editing Heuristics
- Prefer
packages/app-core/ for app shell behavior (API, CLI, onboarding, config).
- Prefer
packages/agent/ for agent providers, services, and runtime glue around elizaOS.
- Prefer
packages/app/ for UI work and packages/app-core/platforms/electrobun/ for the Electrobun native shell.
- Treat
packages/cloud/ as the Eliza Cloud product and backend surface.
Hard Constraints
- Do not remove
NODE_PATH setup.
- Do not remove the Bun exports patch.
- Do not remove Electrobun startup error guards.
- Keep Node and Bun paths working.
Repo Workflow
bun install
bun run verify
bun run test
Narrower commands when useful:
bun run start
bun run dev
bun run dev:desktop
bun run test:e2e
Where to Look First
- Product and runtime behavior:
packages/app-core/src/
- Prompt, provider, and skill plumbing:
packages/agent/src/
- Onboarding and routing:
packages/ui/src/first-run/ and packages/app-core/src/runtime/
- Shipped default skills: bundled in
@elizaos/skills, seeded into the state-dir skills folder by packages/app-core/scripts/ensure-skills.mjs
- Eliza Cloud backend or monetization:
packages/cloud/ and the shipped eliza-cloud skill
Cloud Default
If the task involves building an app and Eliza Cloud is enabled, linked, or explicitly requested, treat Cloud as the default managed backend before inventing custom auth, billing, analytics, or hosting. Use the eliza-cloud skill for app, monetization, and container details.
Related Skills
elizaos — core runtime abstractions and upstream plugin patterns
eliza-cloud — apps, billing, monetization, auth, containers
1---2name: eliza-app-development3description: Use when building or changing an elizaOS-based application in this repository. Covers eliza app architecture, monorepo layout, local versus remote versus cloud routing, where to edit features, and non-negotiable runtime constraints. Eliza is the product name of this particular eliza app checkout.4---5
6# eliza app development
7
8This repository is an **elizaOS application**: a local-first assistant with CLI, dashboard, Electrobun desktop shell, connectors, and Eliza Cloud integration. **Eliza** is this app’s product and CLI name—not a separate platform from elizaOS.
9
10## Read These References First
11
12- `references/repo-map.md` for layout, edit targets, and common commands
13- `references/runtime-and-cloud.md` for runtime flow, onboarding, service routing, skills, and Eliza Cloud behavior
14
15## Editing Heuristics
16
17- Prefer `packages/app-core/` for app shell behavior (API, CLI, onboarding, config).
18- Prefer `packages/agent/` for agent providers, services, and runtime glue around elizaOS.
19- Prefer `packages/app/` for UI work and `packages/app-core/platforms/electrobun/` for the Electrobun native shell.
20- Treat `packages/cloud/` as the Eliza Cloud product and backend surface.
21
22## Hard Constraints
23
24- Do not remove `NODE_PATH` setup.
25- Do not remove the Bun exports patch.
26- Do not remove Electrobun startup error guards.
27- Keep Node and Bun paths working.
28
29## Repo Workflow
30
31```bash
32bun install
33bun run verify
34bun run test
35```
36
37Narrower commands when useful:
38
39```bash
40bun run start
41bun run dev
42bun run dev:desktop
43bun run test:e2e
44```
45
46## Where to Look First
47
48- Product and runtime behavior: `packages/app-core/src/`
49- Prompt, provider, and skill plumbing: `packages/agent/src/`
50- Onboarding and routing: `packages/ui/src/first-run/` and `packages/app-core/src/runtime/`
51- Shipped default skills: bundled in `@elizaos/skills`, seeded into the state-dir skills folder by `packages/app-core/scripts/ensure-skills.mjs`
52- Eliza Cloud backend or monetization: `packages/cloud/` and the shipped `eliza-cloud` skill
53
54## Cloud Default
55
56If the task involves building an app and Eliza Cloud is enabled, linked, or explicitly requested, treat Cloud as the default managed backend before inventing custom auth, billing, analytics, or hosting. Use the `eliza-cloud` skill for app, monetization, and container details.
57
58## Related Skills
59
60- `elizaos` — core runtime abstractions and upstream plugin patterns
61- `eliza-cloud` — apps, billing, monetization, auth, containers