Skip to content

Latest commit

 

History

History
 
 

app-core

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

@elizaos/app-core

Shared application core for elizaOS agent app shells (desktop, mobile, web). It bundles the pieces every shell needs: the CLI bootstrap, the dashboard HTTP API, the Eliza runtime loader, the static app/plugin/connector registry, auth/secrets/vault services, and per-platform bootstrap.

What's in here

Subdir Contains
src/entry.ts CLI process bootstrap (built to dist/entry.js, imported by the generated app launcher).
src/cli/ Commander CLI: start, setup, doctor, db, config, dashboard, update, auth, …
src/api/ Dashboard HTTP API: server, auth/pairing routes, dev-stack discovery, secrets/wallet routes.
src/runtime/ Eliza composition layer, focused startup lifecycle modules, dev server, runtime-mode, and Electrobun desktop runtimes.
src/registry/ Compatibility re-export of the canonical @elizaos/registry/first-party registry.
src/security/ Agent vault id + platform secure stores + wallet key hydration.
src/services/ Auth store, steward credentials/sidecar, vault mirror/bootstrap, account pool, and more.
src/platform/ Per-platform bootstrap (Capacitor for mobile, browser stubs, native plugin entrypoints).
src/config/ AppConfig types and DEFAULT_APP_CONFIG (re-exported from @elizaos/shared).

Usage

// Node/runtime barrel
import { startApiServer, loadRegistry, getPlugins } from "@elizaos/app-core";

// Targeted subpaths (see package.json exports for the full list)
import { loadRegistry } from "@elizaos/registry/first-party";
import { ensureRouteAuthorized } from "@elizaos/app-core/api/auth";
import { deriveAgentVaultId } from "@elizaos/app-core/security/agent-vault-id";

The full subpath list lives in the exports map of package.json.

Build & test

bun run --cwd packages/app-core build       # tsc → flatten → copy assets → rewrite dist ESM imports
bun run --cwd packages/app-core typecheck   # tsgo --noEmit
bun run --cwd packages/app-core test         # vitest
bun run --cwd packages/app-core lint         # Biome

This package is consumed by @elizaos/agent, @elizaos/ui, @elizaos/shared, the packages/app shell, and most plugins/* app plugins. It targets Node >=24, with react/react-dom/three as peer dependencies and the @elizaos/capacitor-* mobile bridges as optional dependencies.